Method assetlinks.check

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

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

Los sistemas de infraestructura usan este comando con mayor frecuencia a fin de verificar las condiciones previas para realizar una acción. Por ejemplo, es posible que un cliente desee saber si está bien enviar una URL web a una aplicación para dispositivos móviles en particular. El cliente puede buscar el vínculo de recursos relevante del sitio web y la aplicación para dispositivos móviles a fin de decidir si se debe permitir la operación.

Nota sobre la seguridad: si especificas un activo seguro como fuente, por ejemplo, un sitio web HTTPS o una app de Android, la API se asegurará de que el propietario de dicho activo haya hecho las declaraciones que se usaron para generar la respuesta de manera segura. Por el contrario, si el recurso de origen es un sitio web HTTP no seguro (es decir, la URL comienza con http:// en lugar de https://), la API no puede verificar sus declaraciones de forma segura, y no es posible garantizar que un tercero no 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 instrucciones. Se usa para enrutar la llamada Check() a la fuente adecuada.
relation string

Cadena de consulta de la relación

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

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

Para que una consulta coincida con un vínculo de elemento, tanto las strings de relación de la consulta como las 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 elemento con la relación delegate_permission/common.handle_all_urls.
target object(Asset) Es el elemento de destino del resumen.

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 CheckAssetLinks.

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

Desde el momento de la publicación, cuánto tiempo más se debe considerar la respuesta como válida, tras la prohibición de las actualizaciones. REQUIRED

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

Mensaje legible que incluye 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 traducciones.

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

Pruébela.

Usa el Explorador de API para llamar a este método en datos en vivo y ver la respuesta.