Cada instrução é criada pensando no consumidor. A instrução é aquela que lê e verifica uma declaração feita por um diretor e, em seguida, realiza uma ação com base nela. Mais especificamente, um consumidor executa estas etapas básicas:
- Solicitar a lista de instruções de uma conta principal específica
- Verifique se a lista contém uma determinada instrução em relação a um determinado destino
- Confirme se o destino na declaração é o destino (site ou app) que você acredita ser.
- Realize a ação especificada pela instrução, se você optar por
Muitos casos de uso consomem instruções em segundo plano. Por exemplo, a vinculação de apps Android usa instruções de permissão de link feitas por um site para ativar links diretamente em um app. Um app indica que concorda em ser um destino para qualquer uma dessas instruções adicionando um código especial (um gerenciador de intent) ao manifesto.
É possível executar as etapas 1 e 2 acima (solicitar e validar uma declaração) de duas maneiras: usando a API ou manualmente (usando sua própria implementação).
Como consumir instruções usando a API Digital Asset Links
A API Digital Asset Links é compatível com dois métodos: Check() e List() para encontrar ou validar instruções:
Check()recebe uma origem, um destino e um relacionamento e verifica se a origem faz a instrução enviada sobre o destino.List()lista todas as instruções feitas por uma determinada origem.
Como consumir instruções manualmente
O protocolo Digital Asset Links está aberto, então você pode criar uma implementação dele.
Para consumir instruções feitas por sites da Web, você pode fazer uma solicitação HTTP GET para a lista de instruções correspondente e analisá-la por conta própria. Por exemplo, a lista de instruções correspondente para o site http://example.digitalassetlinks.org está em http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Para consumir declarações feitas por apps Android, é necessário acessar o manifesto do pacote de APK correspondente. Em dispositivos Android, isso pode ser feito usando a interface PackageManager.
Preste atenção aos significados específicos das declarações dos links de recursos digitais. Consulte a Especificação de links de recursos caso não tenha certeza.