Cada declaración está diseñada con un consumidor en mente; el consumidor del resumen es el que lee y verifica una declaración realizada por un principal y, luego, toma medidas en función de esa declaración. Más específicamente, un consumidor realiza estos pasos básicos:
- Solicita la lista de declaraciones de una principal específica
- Verifica si la lista contiene una sentencia dada en comparación con un objetivo determinado.
- Valida que el objetivo de la instrucción sea el objetivo (sitio web o aplicación) que crees que es
- Realizar la acción especificada en la instrucción, si así lo deseas
Muchos casos de uso consumen sentencias detrás de escena. Por ejemplo, Android App Linking consume declaraciones de permisos de vínculos realizadas por un sitio web para habilitar vínculos directamente a una app. Una app indica que acepta ser un objetivo para cualquiera de esas declaraciones agregando un código especial (un controlador de intents) en su manifiesto.
Puedes realizar los pasos 1 y 2 anteriores (solicitar y validar una declaración) de dos maneras: usando nuestra API o manualmente (con tu propia implementación).
Cómo consumir declaraciones con la API de Vínculos de recursos digitales
La API de Vínculos de recursos digitales admite dos métodos, Check() y List(), para encontrar o validar declaraciones:
Check()toma una fuente, un destino y una relación, y verifica que la fuente realice la declaración enviada sobre el destino.List()enumera todas las declaraciones de una fuente determinada.
Consumo manual de instrucciones
El protocolo de Vínculos de recursos digitales es abierto, por lo que puedes crear una implementación por tu cuenta.
Para consumir las declaraciones de sitios web, puedes realizar una solicitud GET de HTTP para la lista de instrucciones correspondiente y analizarla tú mismo. Por ejemplo, la lista de sentencias correspondiente para el sitio web http://example.digitalassetlinks.org se encuentra en http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Para consumir las declaraciones realizadas por apps para Android, debes acceder al manifiesto del paquete de APK correspondiente. En dispositivos Android, esto se puede lograr con la interfaz PackageManager.
Presta especial atención a los significados específicos de las declaraciones de Vínculos de recursos digitales. Consulta la especificación de los vínculos de recursos si tienes dudas.