tipo de recurso de marcador

Espaço de nomes: 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.

Representa um marcador que é uma resposta administrativa nos resultados do Microsoft Search para consultas de pesquisa comuns numa organização. Um marcador tem muitas propriedades que permitem aos administradores tornar os recursos comuns mais acessíveis na sua organização.

Herda de searchAnswer.

Métodos

Método	Tipo de retorno	Descrição
List	coleção microsoft.graph.search.bookmark	Obtenha uma lista dos objetos de marcador e respetivas propriedades.
Create	microsoft.graph.search.bookmark	Create um novo objeto de marcador.
Get	microsoft.graph.search.bookmark	Leia as propriedades e relações de um objeto de marcador .
Atualizar	microsoft.graph.search.bookmark	Atualize as propriedades de um objeto de marcador .
Delete	Nenhum	Eliminar um objeto de marcador .

Propriedades

Propriedade	Tipo	Descrição
availabilityEndDateTime	DateTimeOffset	Data e hora em que o marcador deixa de aparecer como resultado da pesquisa. Defina como null para sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora com 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 marcador começa a aparecer como um resultado de pesquisa. Defina como null para sempre disponível. O tipo de carimbo de data/hora representa informações de data e hora com 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 normalmente utilizadas para descrever este marcador. Por exemplo, IT e HR.
description	Cadeia de caracteres	A descrição do marcador apresentada na página de resultados da pesquisa. Herdado de searchAnswer.
displayName	Cadeia de caracteres	O nome do marcador que é apresentado nos resultados da pesquisa. Herdado de searchAnswer.
groupIds	Coleção de cadeias de caracteres	A lista de grupos de segurança que podem ver este marcador.
isSuggested	Booliano	True se este marcador tiver sido sugerido ao administrador, por um utilizador ou tiver sido extraído e sugerido pela Microsoft. Somente leitura.
id	Cadeia de caracteres	O identificador exclusivo (GUID) do marcador. Herdado de searchAnswer.
palavras-chave	microsoft.graph.search.answerKeyword	Palavras-chave que acionam este marcador para aparecerem nos resultados da pesquisa.
languageTags	String collection	Uma lista de nomes de idioma geograficamente específicos nos quais este marcador pode ser visualizado. Cada valor de etiqueta de idioma segue o padrão {language}-{region}. Por exemplo, é inglês, en-us conforme utilizado no Estados Unidos. Para obter a lista de valores possíveis, veja Etiquetas de idioma suportadas.
lastModifiedBy	microsoft.graph.identitySet	Detalhes do utilizador que criou ou modificou o marcador pela última vez. Herdado de searchAnswer. Somente leitura.
lastModifiedDateTime	DateTimeOffset	Data e hora em que o marcador foi criado ou editado pela última vez. O tipo de carimbo de data/hora representa informações de data e hora com 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. Herdado de searchAnswer. Somente leitura.
plataformas	coleção microsoft.graph.devicePlatformType	Lista de dispositivos e sistemas operativos que conseguem ver este marcador. Os valores possíveis são: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement e unknownFutureValue.
powerAppIds	Coleção de cadeias de caracteres	Lista de Power Apps associados a este marcador. Se os utilizadores adicionarem o Power Apps existente a um marcador, podem concluir tarefas diretamente na página de resultados da pesquisa, como introduzir o tempo de férias ou reportar despesas.
state	microsoft.graph.search.answerState	Estado do marcador. Os valores possíveis são: published, draft, excluded, unknownFutureValue.
targetedVariations	coleção microsoft.graph.search.answerVariant	Variações de um marcador para diferentes países ou dispositivos. Utilize quando precisar de mostrar conteúdos diferentes aos utilizadores com base no respetivo dispositivo, país/região ou ambos. As definições de data e grupo aplicam-se a todas as variações.
webUrl	String	A ligação do URL para o marcador. Quando os utilizadores selecionam este marcador nos resultados da pesquisa, são direcionados para o URL especificado. Herdado de searchAnswer.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.search.bookmark",
  "availabilityEndDateTime": "String (timestamp)",
  "availabilityStartDateTime": "String (timestamp)",
  "categories": ["String"],
  "description": "String",
  "displayName": "String",
  "groupIds": ["String"],
  "id": "String (identifier)",
  "isSuggested": "Boolean",
  "keywords": {"@odata.type": "microsoft.graph.search.answerKeyword"},
  "languageTags": ["String"],
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "platforms": ["String"],
  "powerAppIds": ["String"],
  "state": "String",
  "targetedVariations": [{"@odata.type": "microsoft.graph.search.answerVariant"}],
  "webUrl": "String"
}