Consume una instrucción

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:

1. Solicita la lista de declaraciones de una principal específica
2. Verifica si la lista contiene una sentencia dada en comparación con un objetivo determinado.
3. Valida que el objetivo de la instrucción sea el objetivo (sitio web o aplicación) que crees que es
4. 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.

Asegúrate de verificar que tu situación no tenga un mecanismo especial para consumir o implementar una sentencia antes de manejarla de forma manual.

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.

Para usar la API, necesitas una clave de API y, primero, debes activarla para tu proyecto. Para hacerlo, sigue estos pasos:

1. Ve a Google Developers Console.

   Es posible que primero debas acceder a la consola.

2. Selecciona o crea un proyecto.

   Si tienes varios proyectos, asegúrate de estar en el proyecto para el que deseas activar la API de Vínculos de recursos digitales y haz clic en Continuar. O bien, si no tienes un proyecto, selecciona Crear un proyecto nuevo y haz clic en Crear.

3. En la descripción general de la API de Digital Asset Links, haz clic en Habilitar API.

   Si la API ya está habilitada para tu proyecto, verás Inhabilitar API.

4. En el menú de la izquierda, haz clic en Credenciales y selecciona o crea una clave de API.

   Obtén más información sobre la creación de claves de API.

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.