Compartilhar via


Criar acrónimo

Espaço de nomes: microsoft.graph.search

Crie um novo objeto de acrónimo .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

Solicitação HTTP

POST /search/acronyms

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto de acrónimo .

A tabela seguinte mostra as propriedades que estão disponíveis quando cria um acrónimo.

Propriedade Tipo Descrição
description Cadeia de caracteres Uma breve descrição do acrónimo que dá aos utilizadores mais informações sobre o acrónimo e o que significa. Herdado de searchAnswer.
displayName Cadeia de caracteres A forma curta real ou acrónimo. Herdado de searchAnswer.
standsFor Cadeia de caracteres O que significa o acrónimo.
state microsoft.graph.search.answerState Estado do acrónimo. Os valores possíveis são: published, draft, excluded, unknownFutureValue.
webUrl String O URL da página ou site onde os utilizadores podem aceder para obter mais informações sobre o acrónimo. Herdado de searchAnswer.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta com o ID do acrónimo criado.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/search/acronyms
Content-Type: application/json

{
  "displayName": "DNN",
  "standsFor": "Deep Neural Network",
  "description": "A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers.",
  "webUrl": "http://microsoft.com/deep-neural-network",
  "state": "draft"
}

Resposta

O exemplo a seguir mostra a resposta.

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

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}