Actualizar marcador
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.
Actualice las propiedades de un 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
PATCH /search/bookmarks/{bookmarksId}
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 solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.
En la tabla siguiente se especifican las propiedades que se pueden actualizar.
Nota: Las actualizaciones de las propiedades de una colección, como palabras clave o categorías, reemplazan a toda la colección.
| 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 string | 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 de cadenas | 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 string | 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 código de respuesta 204 No Content.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/search/bookmarks/733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json
{
"description": "Book a fancy vacation in Tuscany or browse museums in Florence."
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content