지정된 소스와 타겟 애셋 간에 지정된 (방향) 관계가 존재하는지 여부를 결정합니다.
관계는 소스 저작물에서 소유권을 주장한 대로 두 저작물 간의 링크 인텐트를 설명합니다. 이러한 관계의 예로는 권한 위임이 있습니다.
이 명령어는 인프라 시스템에서 작업의 전제 조건을 확인하는 데 가장 많이 사용됩니다. 예를 들어 클라이언트는 특정 모바일 앱에 웹 URL을 전송해도 괜찮은지 알고자 할 수 있습니다. 고객은 웹사이트에서 모바일 앱으로 연결되는 관련 애셋 링크를 확인하여 작업 허용 여부를 결정할 수 있습니다.
보안 관련 참고사항: HTTPS 웹사이트 또는 Android 앱과 같이 보안 애셋을 소스로 지정하면 API는 응답을 생성하는 데 사용되는 모든 문이 해당 애셋의 소유자가 안전한 방식으로 생성했는지 확인합니다. 반대로 소스 애셋이 안전하지 않은 HTTP 웹사이트인 경우 (즉, URL이 https://
가 아닌 http://
로 시작하는 경우) API는 문을 안전하게 확인할 수 없으며 제3자가 웹사이트의 문을 변경하지 않았는지 확인할 수 없습니다. 자세한 내용은 디지털 애셋 링크 기술 설계 사양을 참조하세요.
HTTP 요청
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
쿼리 매개변수
매개변수 이름 | 유형 | 설명 |
---|---|---|
source |
object( |
명세서 목록을 호스팅하는 소스입니다. Check() 호출을 적절한 소스로 라우팅하는 데 사용됩니다. |
relation |
string |
관계의 쿼리 문자열입니다.
현재 지원되는 관계 목록은 API 문서를 참고하세요. 쿼리가 애셋 링크와 일치하도록 하려면 쿼리와 애셋 링크의 관계 문자열이 모두 정확히 일치해야 합니다. 예: 관계가 |
target |
object( |
명세서의 타겟 애셋입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
CheckAssetLinks 호출에 대한 응답 메시지입니다.
JSON 표현 |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
필드 이름 | 유형 | 설명 |
---|---|---|
linked |
boolean |
요청에 지정된 애셋이 요청에 지정된 관계로 연결되는 경우 true로 설정합니다. REQUIRED |
maxAge |
string |
제공 시간으로부터 응답이 유효한 업데이트로 간주되어야 하는 기간을 나타냅니다. REQUIRED 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
debugString |
string |
최종 사용자가 결과를 이해하고 재현하고 디버그하는 데 도움이 되는 정보를 포함하고 있으며 사람이 읽을 수 있는 메시지입니다. 메시지는 영어로 제공되며 현재 Google에서는 번역을 제공할 계획이 없습니다. 이 문자열의 내용이나 형식은 보장되지 않습니다. 또한 일부 사항은 예고 없이 변경될 수 있습니다. 이 데이터를 프로그래매틱 방식으로 파싱하려고 해서는 안 됩니다. 필요한 정보가 API를 통해 노출되지 않기 때문에 이 작업을 수행해야 한다고 생각되면 먼저 Google에 문의해 주세요. |
사용해 보기
API 탐색기를 사용하여 실시간 데이터에서 이 메서드를 호출하고 응답을 확인하세요.