Method assetlinks.check

Determina si existe la relación especificada (direccional) entre los recursos de origen y de destino especificados.

La relación describe la intención del vínculo entre los dos activos según lo reclamado por el activo de origen. Un ejemplo de estas relaciones es la delegación de privilegios o permisos.

Los sistemas de infraestructura usan este comando con mayor frecuencia para verificar las condiciones previas de una acción. Por ejemplo, es posible que un cliente quiera saber si puede enviar una URL web a una determinada aplicación para dispositivos móviles en su lugar. El cliente puede buscar el vínculo del recurso relevante desde el sitio web hasta la aplicación para dispositivos móviles para decidir si se debe permitir la operación.

Nota sobre la seguridad: Si especificas un recurso seguro como la fuente, por ejemplo, un sitio web HTTPS o una app para Android, la API se asegurará de que el propietario de ese recurso haya realizado de manera segura las declaraciones que se usen para generar la respuesta. Por el contrario, si el recurso de origen es un sitio web HTTP no seguro (es decir, si la URL comienza con http:// en lugar de https://), la API no puede verificar sus sentencias de forma segura y no es posible garantizar que ningún tercero haya alterado las declaraciones del sitio web. Para obtener más información, consulta la especificación de diseño técnico de Vínculos de recursos digitales.

Solicitud HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Parámetros de consulta

Nombre del parámetro Tipo Descripción
source object(Asset) La fuente que aloja la lista de declaraciones. Se usa para enrutar la llamada a Check() a la fuente correcta.
relation string

Cadena de consulta para la relación.

Identificamos relaciones con cadenas del formato <kind>/<detail>, en las que <kind> debe ser una de un conjunto de categorías de propósito predefinidas, y <detail> es una cadena alfanumérica en minúscula de formato libre que describe el caso de uso específico de la instrucción.

Consulta nuestra documentación de la API para ver la lista actual de relaciones admitidas.

Para que una consulta coincida con el vínculo de un elemento, las cadenas de relación de la consulta y del vínculo del elemento deben coincidir exactamente.

Ejemplo: Una consulta con la relación delegate_permission/common.handle_all_urls coincide con un vínculo de elementos con la relación delegate_permission/common.handle_all_urls.
target object(Asset) Es el recurso objetivo del estado.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Mensaje de respuesta para la llamada a CheckAssetLinks.

Representación JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Nombre del campo Tipo Descripción
linked boolean Se establece como verdadero si los activos especificados en la solicitud están vinculados mediante la relación especificada en la solicitud. REQUIRED
maxAge string

A partir del tiempo de publicación, indica durante cuánto tiempo la respuesta debe considerarse válida, excepto las actualizaciones adicionales. REQUIRED

Es una duración en segundos con hasta nueve dígitos fraccionarios que termina en "s". Ejemplo: "3.5s".
debugString string

Mensaje legible por humanos que contiene información destinada a ayudar a los usuarios finales a comprender, reproducir y depurar el resultado.

El mensaje se mostrará en inglés y, por el momento, no planeamos ofrecer ninguna traducción.

Ten en cuenta que no se garantiza el contenido ni el formato de esta cadena. Cualquier aspecto del documento puede estar sujeto a cambios sin previo aviso. No debes intentar analizar estos datos de forma programática. Si consideras que debes hacerlo porque la API no expone de otra manera la información que necesitas, primero comunícate con nosotros.

Pruébalo

Utiliza el Explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.