Determina se a relação (direcional) especificada existe entre os recursos de origem e destino especificados.
A relação descreve a intenção do vínculo entre os dois recursos, conforme reivindicado pelo recurso de origem. Um exemplo dessas relações é a delegação de privilégios ou permissões.
Esse comando é mais usado por sistemas de infraestrutura para verificar as condições prévias de uma ação. Por exemplo, um cliente pode querer saber se é possível enviar um URL da Web para um determinado aplicativo para dispositivos móveis. O cliente pode verificar o link de recurso relevante do site para o app para dispositivos móveis e decidir se a operação é permitida.
Observação sobre segurança: se você especificar um recurso seguro como a origem, como um site HTTPS ou um app Android, a API vai garantir que as instruções usadas para gerar a resposta tenham sido feitas de maneira segura pelo proprietário desse recurso. Por outro lado, se o recurso de origem for um site HTTP não seguro (ou seja, o URL começar com http://
em vez de https://
), a API não poderá verificar as instruções com segurança e não será possível garantir que as instruções do site não tenham sido alteradas por terceiros. Para mais informações, consulte a especificação do design técnico do Digital Asset Links.
Solicitação HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parâmetros de consulta
Nome do parâmetro | Tipo | Descrição |
---|---|---|
source |
object( |
Fonte que hospeda a lista de instruções. Isso é usado para rotear a chamada Check() para a origem adequada. |
relation |
string |
String de consulta da relação. Identificamos relações com strings do formato Consulte a documentação da API para a lista atual de relações compatíveis. Para que uma consulta corresponda a um link de recurso, as strings de relação da consulta e do link do recurso devem corresponder exatamente. Exemplo: uma consulta com relação |
target |
object( |
O recurso de destino da instrução. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Mensagem de resposta para a chamada de CheckAssetLinks.
Representação JSON |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
Nome do campo | Tipo | Descrição |
---|---|---|
linked |
boolean |
Defina como verdadeiro se os recursos especificados na solicitação estiverem vinculados pela relação definida nela. REQUIRED |
maxAge |
string |
A partir do momento da veiculação, o tempo de espera da resposta deve ser considerada válida, exceto no caso de futuras atualizações. REQUIRED Uma duração em segundos com até nove dígitos fracionários, encerrada por " |
debugString |
string |
Mensagem legível por humanos contendo informações destinadas a ajudar os usuários finais a entender, reproduzir e depurar o resultado. A mensagem será em inglês e não planejamos oferecer traduções no momento. Nenhuma garantia é feita em relação ao conteúdo ou formato dessa string. Qualquer aspecto dele pode estar sujeito a alterações sem aviso prévio. Não tente analisar esses dados de forma programática. Se você acha que precisa fazer isso porque as informações necessárias não estão sendo expostas pela API, entre em contato primeiro. |
Confira!
Use o APIs Explorer para chamar esse método em dados em tempo real e ver a resposta.