Espacio de nombres: microsoft.graph.termStore
Cree un nuevo objeto set .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
TermStore.ReadWrite.All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
No admitida. |
No admitida. |
Solicitud HTTP
POST /sites/{site-id}/termStore/sets
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON del objeto set .
En la tabla siguiente se enumeran las propiedades necesarias al crear el objeto set .
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto microsoft.graph.termStore.set en el cuerpo de la respuesta.
Ejemplos
Solicitud
POST https://graph.microsoft.com/v1.0/sites/6a742cee-9216-4db5-8046-13a595684e74/termStore/sets
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.termStore.set",
"parentGroup":{
"id": "fc733b51-10f1-40fd-b784-dc6d1e42804b"
},
"localizedNames" : [
{
"languageTag" : "en-US",
"name" : "Department"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models.TermStore;
var requestBody = new Set
{
OdataType = "#microsoft.graph.termStore.set",
ParentGroup = new Group
{
Id = "fc733b51-10f1-40fd-b784-dc6d1e42804b",
},
LocalizedNames = new List<LocalizedName>
{
new LocalizedName
{
LanguageTag = "en-US",
Name = "Department",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Sites["{site-id}"].TermStore.Sets.PostAsync(requestBody);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodelstermstore "github.com/microsoftgraph/msgraph-sdk-go/models/termstore"
//other-imports
)
requestBody := graphmodelstermstore.NewSet()
parentGroup := graphmodelstermstore.NewGroup()
id := "fc733b51-10f1-40fd-b784-dc6d1e42804b"
parentGroup.SetId(&id)
requestBody.SetParentGroup(parentGroup)
localizedName := graphmodelstermstore.NewLocalizedName()
languageTag := "en-US"
localizedName.SetLanguageTag(&languageTag)
name := "Department"
localizedName.SetName(&name)
localizedNames := []graphmodelstermstore.LocalizedNameable {
localizedName,
}
requestBody.SetLocalizedNames(localizedNames)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sets, err := graphClient.Sites().BySiteId("site-id").TermStore().Sets().Post(context.Background(), requestBody, nil)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.models.termstore.Set set = new com.microsoft.graph.models.termstore.Set();
set.setOdataType("#microsoft.graph.termStore.set");
com.microsoft.graph.models.termstore.Group parentGroup = new com.microsoft.graph.models.termstore.Group();
parentGroup.setId("fc733b51-10f1-40fd-b784-dc6d1e42804b");
set.setParentGroup(parentGroup);
LinkedList<com.microsoft.graph.models.termstore.LocalizedName> localizedNames = new LinkedList<com.microsoft.graph.models.termstore.LocalizedName>();
com.microsoft.graph.models.termstore.LocalizedName localizedName = new com.microsoft.graph.models.termstore.LocalizedName();
localizedName.setLanguageTag("en-US");
localizedName.setName("Department");
localizedNames.add(localizedName);
set.setLocalizedNames(localizedNames);
com.microsoft.graph.models.termstore.Set result = graphClient.sites().bySiteId("{site-id}").termStore().sets().post(set);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const set = {
'@odata.type': '#microsoft.graph.termStore.set',
parentGroup: {
id: 'fc733b51-10f1-40fd-b784-dc6d1e42804b'
},
localizedNames: [
{
languageTag: 'en-US',
name: 'Department'
}
]
};
await client.api('/sites/6a742cee-9216-4db5-8046-13a595684e74/termStore/sets')
.post(set);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\TermStore\Set;
use Microsoft\Graph\Generated\Models\TermStore\Group;
use Microsoft\Graph\Generated\Models\TermStore\LocalizedName;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new Set();
$requestBody->setOdataType('#microsoft.graph.termStore.set');
$parentGroup = new Group();
$parentGroup->setId('fc733b51-10f1-40fd-b784-dc6d1e42804b');
$requestBody->setParentGroup($parentGroup);
$localizedNamesLocalizedName1 = new LocalizedName();
$localizedNamesLocalizedName1->setLanguageTag('en-US');
$localizedNamesLocalizedName1->setName('Department');
$localizedNamesArray []= $localizedNamesLocalizedName1;
$requestBody->setLocalizedNames($localizedNamesArray);
$result = $graphServiceClient->sites()->bySiteId('site-id')->termStore()->sets()->post($requestBody)->wait();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
Import-Module Microsoft.Graph.Sites
$params = @{
"@odata.type" = "#microsoft.graph.termStore.set"
parentGroup = @{
id = "fc733b51-10f1-40fd-b784-dc6d1e42804b"
}
localizedNames = @(
@{
languageTag = "en-US"
name = "Department"
}
)
}
New-MgSiteTermStoreSet -SiteId $siteId -BodyParameter $params
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.term_store.set import Set
from msgraph.generated.models.term_store.group import Group
from msgraph.generated.models.term_store.localized_name import LocalizedName
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Set(
odata_type = "#microsoft.graph.termStore.set",
parent_group = Group(
id = "fc733b51-10f1-40fd-b784-dc6d1e42804b",
),
localized_names = [
LocalizedName(
language_tag = "en-US",
name = "Department",
),
],
)
result = await graph_client.sites.by_site_id('site-id').term_store.sets.post(request_body)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.termStore.set",
"id": "3607e9f9-e9f9-3607-f9e9-0736f9e90736",
"localizedNames" : [
{
"languageTag" : "en-US",
"name" : "Department"
}
]
}