Method assetlinks.check

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(Asset) 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 <kind>/<detail>, em que <kind> precisa ser um de um conjunto de categorias de finalidade predefinidas, e <detail> é uma string alfanumérica em letras minúsculas de formato livre que descreve o caso de uso específico da instrução.

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 delegate_permission/common.handle_all_urls corresponde a um link de recurso com a relação delegate_permission/common.handle_all_urls.
target object(Asset) 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 "s". Exemplo: "3.5s".
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.