Consume una frase

Todas las afirmaciones están diseñadas para un consumidor. El consumidor es quien lee y verifica la declaración que realizó una principal y, luego, toma las medidas correspondientes. Más concretamente, un consumidor realiza estos pasos básicos:

1. Solicita la lista de instrucciones a una principal específica
2. Comprueba si la lista contiene una declaración dada contra un objetivo determinado.
3. Valide que el objetivo de la afirmación sea el objetivo (sitio web o aplicación) que usted considera.
4. Realice la acción que especifica la declaración si elige

Muchos casos prácticos contienen declaraciones en segundo plano. Por ejemplo, Android App Link consume declaraciones de permisos de vínculos que realiza un sitio web para habilitar vínculos directamente en una app. Una app indica que acepta ser un objetivo para cualquiera de esas declaraciones agregando código especial (un controlador de intents) en su manifiesto.

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

Puedes realizar los pasos 1 y 2 anteriores (solicitar y validar una declaración) de dos maneras: con nuestra API o manualmente (con tu propia implementación).

Consume 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 hechas por 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 Console.

2. Selecciona o crea un proyecto.

   Si tiene varios proyectos, asegúrese de estar en el proyecto en el que desea activar la API de Vínculos de recursos digitales y haga 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 su proyecto, verá Inhabilitar API.

4. En el menú izquierdo, 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 de instrucciones de forma manual

El protocolo de Vínculos de recursos digitales está abierto, por lo que puedes crear una implementación de la herramienta tú mismo.

Para consumir declaraciones hechas por sitios web, puedes realizar una solicitud GET de HTTP a la lista de declaraciones correspondiente y analizarla tú mismo. Por ejemplo, la lista de instrucciones correspondiente para el sitio web http://example.digitalassetlinks.org está en http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Para consumir declaraciones hechas por apps para Android, debes acceder al manifiesto del paquete APK correspondiente. En dispositivos Android, esto se puede lograr con la interfaz PackageManager.

Presta especial atención a los significados específicos de los resúmenes de vínculos de recursos digitales. Consulte la Especificación de vínculos de recursos si no está seguro.