Compartilhar via


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"
}