Criar indicador

Namespace: microsoft.graph.search

Crie um novo objeto de indicador .

Essa API está disponível nas seguintes implantações de nuvem nacional.

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

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) 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/bookmarks

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 da solicitação, forneça uma representação JSON do objeto de marcador .

A tabela a seguir mostra as propriedades disponíveis quando você cria um marcador.

Propriedade Tipo Descrição
availabilityEndDateTime DateTimeOffset Data e hora em que o indicador deixa de aparecer como resultado de pesquisa. Defina como null sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
availabilityStartDateTime DateTimeOffset Data e hora em que o indicador começa a aparecer como resultado da pesquisa. Defina como null sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
categories String collection Categorias comumente usadas para descrever este indicador. Por exemplo, IT e HR.
description Cadeia de caracteres A descrição do indicador mostrada na página de resultados da pesquisa. Herdado de searchAnswer.
displayName Cadeia de caracteres O nome do indicador exibido nos resultados da pesquisa. Herdado de searchAnswer.
groupIds Coleção de cadeias de caracteres A lista de grupos de segurança que podem exibir este indicador.
palavras-chave microsoft.graph.search.answerKeyword As palavras-chave que acionam esse indicador para aparecer nos resultados da pesquisa.
languageTags String collection Uma lista de nomes de idiomas geograficamente específicos nos quais este indicador pode ser visualizado. Cada valor de marca de idioma segue o padrão {language}-{region}. Por exemplo, en-us é o inglês usado nos Estados Unidos. Para obter a lista de valores possíveis, consulte Marcas de idiomas com suporte.
do Azure Coleção microsoft.graph.devicePlatformType Lista de dispositivos e sistemas operacionais que podem exibir este indicador. Os valores possíveis são: android, windows, ios, unknown, macOs.
powerAppIds String collection Lista de Power Apps associados a este indicador. Se os usuários adicionarem Power Apps existentes a um marcador, eles poderão concluir tarefas diretamente na página de resultados da pesquisa, como inserir o tempo de férias ou relatar despesas.
state microsoft.graph.search.answerState Estado do indicador. Os valores possíveis são: published, draft, excluded, unknownFutureValue.
targetedVariations Coleção microsoft.graph.search.answerVariant Variações de um indicador para diferentes países/regiões ou dispositivos. Use quando precisar mostrar conteúdo diferente aos usuários com base no dispositivo, país/região ou ambos. As configurações de data e grupo se aplicam a todas as variações.
webUrl String O link da URL para o indicador. Quando os usuários selecionam esse indicador nos resultados da pesquisa, eles são direcionados para a URL especificada. Herdado de searchAnswer.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta com a ID do indicador criado.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "displayName": "Contoso Install Site",
  "webUrl": "http://www.contoso.com/",
  "description": "Try or buy Contoso for Home or Business and view product information",
  "keywords":  {
    "keywords": ["Contoso", "install"],
    "reservedKeywords": ["Unique keyword"],
    "matchSimilarKeywords": true
  },
  "availabilityStartDateTime": null,
  "availabilityEndDateTime": null,
  "platforms": ["windows"],
  "targetedVariations": [
    {
      "languageTag": "es-es",
      "displayName": "Sitio de instalación Contoso",
      "description": "Pruebe o compre Contoso hogar o negocios y vea la información del producto"
    }
  ],
  "state": "published"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

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