Crear términoCreate term

Espacio de nombres: Microsoft. Graph. termStoreNamespace: microsoft.graph.termStore

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

Crea un nuevo objeto term .Create a new term object.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) TermStore.ReadWrite.AllTermStore.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP request

POST /termStore/sets/{setId}/children
POST /termStore/sets/{setId}/terms/{termId}/children

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione una representación JSON del objeto term .In the request body, supply a JSON representation of the term object.

En la tabla siguiente se muestran las propiedades necesarias al crear el término.The following table shows the properties that are required when you create the term.

PropiedadProperty TipoType DescriptionDescription
Etiquetaslabels colección Microsoft. Graph. termStore. localizedLabelmicrosoft.graph.termStore.localizedLabel collection Etiqueta para el término que se va a crearLabel for the term to be created

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto term en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a term object in the response body.

EjemplosExamples

SolicitudRequest

POST https://graph.microsoft.com/beta/termStore/sets/{setId}/terms
Content-Type: application/json
Content-length: 366

{
  "labels": [
    {
      "languageTag" : "en-US",
      "name" : "Car",
      "isDefault" : true
    }
  ]
}

RespuestaResponse

Nota: el objeto de respuesta que se muestra aquí podría acortarse para facilitar la legibilidad.Note: The response object shown here might be shortened for readability.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "createdDateTime": "2019-06-21T20:01:37Z",
  "id": "8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f",
  "labels" : [
      {
          "name" : "Car",
          "languageTag" : "en-US",
          "isDefault" : true
      }
  ],
  "lastModifiedDateTime": "2019-06-21T20:01:37Z"
}