Method assetlinks.check

Determina se a relação especificada (direcional) existe entre os recursos de origem e destino especificados.

A relação descreve a intenção da vinculação entre os dois recursos conforme reivindicado pelo recurso de origem. Um exemplo desses relacionamentos é a delegação de privilégios ou permissões.

Esse comando é usado com mais frequência pelos sistemas de infraestrutura para verificar as condições prévias de uma ação. Por exemplo, um cliente pode querer saber se é permitido enviar um URL da Web para um determinado app para dispositivos móveis. O cliente pode verificar o link do recurso relevante do site para o app para dispositivos móveis e decidir se a operação deve ser permitida.

Observação sobre segurança: se você especificar um recurso seguro como a fonte, como um site HTTPS ou um app Android, a API garantirá que todas as instruções usadas para gerar a resposta tenham sido feitas de forma 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ça com http:// em vez de https://), a API não pode verificar as instruções com segurança e não é possível garantir que as instruções do site não foram alteradas por terceiros. Para mais informações, consulte a especificação técnica do design de links de recursos digitais.

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) A fonte que hospeda a lista de instruções. Isso é usado para encaminhar a chamada Check() para a origem correta.
relation string

String de consulta da relação.

Identificamos relações com strings no formato <kind>/<detail>, em que <kind> precisa ser um conjunto de categorias de objetivos pré-definidas, e <detail> é uma string alfanumérica em formato livre que descreve o caso de uso específico da instrução.

Consulte a documentação da API para ver 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 de recurso precisam corresponder exatamente.

Exemplo: uma consulta com a 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:

A 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 especificada na solicitação. REQUIRED
maxAge string

A partir do momento da veiculação, quanto tempo a resposta deve ser considerada válida, com exceção das 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 que contém 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.

Nenhuma garantia é feita sobre o conteúdo ou o formato dessa string. Qualquer aspecto dela pode estar sujeito a alterações sem aviso prévio. Não tente analisar esses dados de forma programática. Se você achar que precisa fazer isso porque as informações de que precisa não estão expostas pela API, entre em contato conosco primeiro.

Confira!

Use o APIs Explorer para chamar esse método em dados ativos e ver a resposta.