Créer un terme

Espace de noms : microsoft.graph.termStore

Créez un objet de terme .

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	TermStore.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Non prise en charge.

Requête HTTP

POST sites/{site-id}/termStore/sets/{set-id}/children
POST sites/{site-id}/termStore/sets/{set-id}/terms/{term-id}/children

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet de terme .

Le tableau suivant indique les propriétés requises lorsque vous créez l’objet de terme .

Propriété	Type	Description
Étiquettes	collection microsoft.graph.termStore.localizedLabel	Étiquette du terme à créer.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet microsoft.graph.termStore.term dans le corps de la réponse.

Exemples

Demande

HTTP

POST https://graph.microsoft.com/v1.0/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/462bd0ae-30bb-4c58-845c-761ff6481ac1/children
Content-Type: application/json

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

C#

var graphClient = new GraphServiceClient(requestAdapter);

var requestBody = new Microsoft.Graph.Models.TermStore.Term
{
	Labels = new List<Microsoft.Graph.Models.TermStore.LocalizedLabel>
	{
		new Microsoft.Graph.Models.TermStore.LocalizedLabel
		{
			LanguageTag = "en-US",
			Name = "Car",
			IsDefault = true,
		},
	},
};
var result = await graphClient.Sites["{site-id}"].TermStore.Sets["{set-id}"].Children.PostAsync(requestBody);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const term = {
  labels: [
    {
      languageTag: 'en-US',
      name: 'Car',
      isDefault: true
    }
  ]
};

await client.api('/sites/microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74/termStore/sets/462bd0ae-30bb-4c58-845c-761ff6481ac1/children')
	.post(term);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Term term = new Term();
LinkedList<LocalizedLabel> labelsList = new LinkedList<LocalizedLabel>();
LocalizedLabel labels = new LocalizedLabel();
labels.languageTag = "en-US";
labels.name = "Car";
labels.isDefault = true;
labelsList.add(labels);
term.labels = labelsList;

graphClient.sites("microsoft.sharepoint.com,b9b0bc03-cbc4-40d2-aba9-2c9dd9821ddf,6a742cee-9216-4db5-8046-13a595684e74").termStore().sets("462bd0ae-30bb-4c58-845c-761ff6481ac1").children()
	.buildRequest()
	.post(term);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)

requestBody := graphmodels.NewTerm()


localizedLabel := graphmodels.NewLocalizedLabel()
languageTag := "en-US"
localizedLabel.SetLanguageTag(&languageTag) 
name := "Car"
localizedLabel.SetName(&name) 
isDefault := true
localizedLabel.SetIsDefault(&isDefault) 

labels := []graphmodels.LocalizedLabelable {
	localizedLabel,

}
requestBody.SetLabels(labels)

result, err := graphClient.SitesById("site-id").TermStore().SetsById("set-id").Children().Post(context.Background(), requestBody, nil)

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Sites

$params = @{
	Labels = @(
		@{
			LanguageTag = "en-US"
			Name = "Car"
			IsDefault = $true
		}
	)
}

New-MgSiteTermStoreSetChild -SiteId $siteId -SetId $setId -BodyParameter $params

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);

$requestBody = new Term();
$labelsLocalizedLabel1 = new LocalizedLabel();
$labelsLocalizedLabel1->setLanguageTag('en-US');

$labelsLocalizedLabel1->setName('Car');

$labelsLocalizedLabel1->setIsDefault(true);


$labelsArray []= $labelsLocalizedLabel1;
$requestBody->setLabels($labelsArray);




$requestResult = $graphServiceClient->sitesById('site-id')->termStore()->setsById('set-id')->children()->post($requestBody);

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Réponse

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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"
}