marcador de Create

  • Artículo

Espacio de nombres: microsoft.graph.search

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Create un nuevo objeto bookmark.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

Solicitud HTTP

POST /search/bookmarks

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto bookmark .

En la tabla siguiente se muestran las propiedades que están disponibles al crear un marcador.

Propiedad Tipo Descripción
availabilityEndDateTime DateTimeOffset Fecha y hora en que el marcador deja de aparecer como resultado de la búsqueda. Establézcalo como null para siempre disponible. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
availabilityStartDateTime DateTimeOffset Fecha y hora en que el marcador comienza a aparecer como resultado de la búsqueda. Establézcalo como null para siempre disponible. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
categories Colección string Categorías que se usan normalmente para describir este marcador. Por ejemplo, IT y HR.
description Cadena Descripción del marcador que se muestra en la página de resultados de búsqueda. Se hereda de searchAnswer.
displayName Cadena Nombre del marcador que se muestra en los resultados de la búsqueda. Se hereda de searchAnswer.
groupIds Colección de cadenas Lista de grupos de seguridad que pueden ver este marcador.
keywords microsoft.graph.search.answerKeyword Palabras clave que desencadenan que este marcador aparezca en los resultados de la búsqueda.
languageTags Colección string Lista de nombres de idioma geográficamente específicos en los que se puede ver este marcador. Cada valor de etiqueta de idioma sigue el patrón {language}-{region}. Por ejemplo, en-us es inglés como se usa en el Estados Unidos. Para obtener la lista de valores posibles, consulte Etiquetas de idioma admitidas.
Plataformas Colección microsoft.graph.devicePlatformType Lista de dispositivos y sistemas operativos que pueden ver este marcador. Valores posibles: android, androidForWork, ios, macOS, windowsPhone81, windowsPhone81AndLater, windows10AndLater, androidWorkProfile, unknown, androidASOP, androidMobileApplicationManagement, iOSMobileApplicationManagement, unknownFutureValue.
powerAppIds Colección de cadenas Lista de Power Apps asociada a este marcador. Si los usuarios agregan power apps existentes a un marcador, pueden completar tareas directamente en la página de resultados de búsqueda, como escribir tiempo de vacaciones o notificar gastos.
state microsoft.graph.search.answerState Estado del marcador. Los valores posibles son: published, draft, excluded y unknownFutureValue.
targetedVariations Colección microsoft.graph.search.answerVariant Variaciones de un marcador para diferentes países o dispositivos. Use cuando necesite mostrar contenido diferente a los usuarios en función de su dispositivo, país o región, o ambos. La configuración de fecha y grupo se aplica a todas las variaciones.
webUrl Cadena Vínculo de dirección URL para el marcador. Cuando los usuarios seleccionan este marcador en los resultados de la búsqueda, se dirigen a la dirección URL especificada. Se hereda de searchAnswer.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta con el identificador del marcador creado.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

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