Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha a lista de categorias com suporte que podem aparecer na categories propriedade de um applicationTemplate. Cada entrada inclui o valor subjacente usado pela API e um nome de exibição localizável adequado para exibição em uma interface do usuário.
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
Sem suporte. |
Sem suporte. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Aplicativo |
Sem suporte. |
Sem suporte. |
Permissões adicionais não são necessárias para chamar essa API, desde que seu aplicativo tenha um token de acesso válido para chamar o Microsoft Graph.
Solicitação HTTP
GET /applicationTemplates/microsoft.graph.categories
Parâmetros de consulta opcionais
Esse método dá suporte aos $selectparâmetros de consulta , $filter, , $orderby$tope $skip OData para ajudar a personalizar a resposta. A paginação do lado do servidor não é compatível, portanto, a resposta não inclui uma @odata.nextLink propriedade. Para obter informações gerais, acesse Parâmetros de consulta OData.
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Accept-Language |
Código de idioma. Opcional. Fornecer a esse cabeçalho um código de idioma com suporte, como cs ou de-DE, retorna os valores displayName localizados para esse idioma, quando disponíveis. Se o cabeçalho não for especificado ou o idioma solicitado não estiver disponível, os valores displayName serão retornados em inglês. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedida, essa função retornará um código de 200 OK resposta e uma coleção applicationTemplateCategory no corpo da resposta.
Exemplos
Exemplo 1: obter a lista de categorias com suporte
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/applicationTemplates/microsoft.graph.categories
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.ApplicationTemplates["{applicationTemplate-id}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
applicationTemplates, err := graphClient.ApplicationTemplates().ByApplicationTemplateId("applicationTemplate-id").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
ApplicationTemplate result = graphClient.applicationTemplates().byApplicationTemplateId("{applicationTemplate-id}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let categories = await client.api('/applicationTemplates/microsoft.graph.categories')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->applicationTemplates()->byApplicationTemplateId('applicationTemplate-id')->get()->wait();
Import-Module Microsoft.Graph.Beta.Applications
Get-MgBetaApplicationTemplate -ApplicationTemplateId $applicationTemplateId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.application_templates.by_application_template_id('applicationTemplate-id').get()
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.applicationTemplateCategory)",
"value": [
{
"value": "contentSharing",
"displayName": "Content Sharing"
},
{
"value": "collaboration",
"displayName": "Collaboration"
},
{
"value": "health",
"displayName": "Health"
},
{
"value": "crm",
"displayName": "CRM"
},
{
"value": "productivity",
"displayName": "Productivity"
}
]
}
Exemplo 2: obter a lista de categorias com suporte com nomes de exibição localizados
O exemplo a seguir usa o Accept-Language cabeçalho para solicitar valores displayName localizados em tcheco.
Solicitação
GET https://graph.microsoft.com/beta/applicationTemplates/microsoft.graph.categories
Accept-Language: cs
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.ApplicationTemplates["{applicationTemplate-id}"].GetAsync((requestConfiguration) =>
{
requestConfiguration.Headers.Add("Accept-Language", "cs");
});
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
abstractions "github.com/microsoft/kiota-abstractions-go"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphapplicationtemplates "github.com/microsoftgraph/msgraph-beta-sdk-go/applicationtemplates"
//other-imports
)
headers := abstractions.NewRequestHeaders()
headers.Add("Accept-Language", "cs")
configuration := &graphapplicationtemplates.ApplicationTemplateItemRequestBuilderGetRequestConfiguration{
Headers: headers,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
applicationTemplates, err := graphClient.ApplicationTemplates().ByApplicationTemplateId("applicationTemplate-id").Get(context.Background(), configuration)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
ApplicationTemplate result = graphClient.applicationTemplates().byApplicationTemplateId("{applicationTemplate-id}").get(requestConfiguration -> {
requestConfiguration.headers.add("Accept-Language", "cs");
});
const options = {
authProvider,
};
const client = Client.init(options);
let categories = await client.api('/applicationTemplates/microsoft.graph.categories')
.version('beta')
.header('Accept-Language','cs')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\ApplicationTemplates\Item\ApplicationTemplateItemRequestBuilderGetRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new ApplicationTemplateItemRequestBuilderGetRequestConfiguration();
$headers = [
'Accept-Language' => 'cs',
];
$requestConfiguration->headers = $headers;
$result = $graphServiceClient->applicationTemplates()->byApplicationTemplateId('applicationTemplate-id')->get($requestConfiguration)->wait();
Import-Module Microsoft.Graph.Beta.Applications
Get-MgBetaApplicationTemplate -ApplicationTemplateId $applicationTemplateId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.application_templates.item.application_template_item_request_builder import ApplicationTemplateItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_configuration = RequestConfiguration()
request_configuration.headers.add("Accept-Language", "cs")
result = await graph_client.application_templates.by_application_template_id('applicationTemplate-id').get(request_configuration = request_configuration)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.applicationTemplateCategory)",
"value": [
{
"value": "contentSharing",
"displayName": "Sdílení obsahu"
},
{
"value": "collaboration",
"displayName": "Spolupráce"
},
{
"value": "health",
"displayName": "Zdraví"
},
{
"value": "crm",
"displayName": "CRM"
},
{
"value": "productivity",
"displayName": "Produktivita"
}
]
}