indicador Create
Namespace: microsoft.graph.search
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.
Create um novo objeto de indicador.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
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 indicador .
A tabela a seguir mostra as propriedades que estão disponíveis quando você cria um indicador.
Propriedade | Tipo | Descrição |
---|---|---|
availabilityEndDateTime | DateTimeOffset | Data e hora em que o indicador para de aparecer como resultado da pesquisa. Defina como null para sempre disponível. O tipo de carimbo de data e 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 para sempre disponível. O tipo de carimbo de data e 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 | Coleção de cadeias de caracteres | Categorias comumente usadas para descrever esse 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 esse indicador. |
palavras-chave | microsoft.graph.search.answerKeyword | Palavras-chave que disparam esse indicador para aparecer nos resultados da pesquisa. |
languageTags | String collection | Uma lista de nomes de idioma geograficamente específicos em que esse indicador pode ser exibido. Cada valor de marca de idioma segue o padrão {language}-{region}. Por exemplo, en-us é inglês conforme usado no Estados Unidos. Para obter a lista de valores possíveis, consulte Marcas de idioma com suporte. |
Plataformas | coleção microsoft.graph.devicePlatformType | Lista de dispositivos e sistemas operacionais que podem exibir esse indicador. Os valores possíveis são: android , androidForWork , ios , macOS , windowsPhone81 , windowsPhone81AndLater , windows10AndLater , androidWorkProfile , unknown , androidASOP , androidMobileApplicationManagement , iOSMobileApplicationManagement e unknownFutureValue . |
powerAppIds | Coleção String | Lista de Aplicativos do Power associados a este indicador. Se os usuários adicionarem os Power Apps existentes a um indicador, eles poderão concluir tarefas diretamente na página de resultados da pesquisa, como inserir 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 ou dispositivos. Use quando precisar mostrar conteúdo diferente aos usuários com base em seu 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 de 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/beta/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"
}