marcador de Create
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"
}