Method statements.list

지정된 대상 및 문 문자열과 일치하는 지정된 소스의 모든 문 목록을 검색합니다.

API는 디지털 애셋 링크 기술 설계 사양에 설명된 대로 HTTPS 웹사이트 또는 Android 앱과 같이 보안 소스 애셋이 포함된 모든 명세서를 이러한 애셋의 소유자가 안전한 방식으로 생성했는지 확인합니다. 특히 안전하지 않은 웹사이트 (즉, URL이 https:// 대신 http://로 시작하는 페이지)에 대해서는 보장할 수 없습니다.

List 명령어는 API 클라이언트가 두 애셋이 관련된 모든 방식을 파악하거나 특정 소스 애셋의 모든 관계를 열거하려는 경우에 가장 유용합니다. 예: 사용자가 관련 항목으로 이동하는 데 도움이 되는 기능 모바일 앱이 기기에서 실행될 때 이 기능을 사용하면 해당 웹사이트 또는 Google+ 프로필로 쉽게 이동할 수 있습니다.

HTTP 요청

GET https://digitalassetlinks.googleapis.com/v1/statements:list

쿼리 매개변수

매개변수 이름 유형 설명
source object(Asset) 명세서 목록을 호스팅하는 소스입니다. List() 요청을 올바른 소스로 전달하는 데 사용됩니다. REQUIRED
relation string

지정된 관계와 일치하는 연결만 사용합니다.

관계 문자열의 자세한 정의는 Statement 메시지를 참고하세요.

쿼리가 문과 일치하도록 하려면 다음 중 하나에 해당해야 합니다.

  • 쿼리와 문의 관계 문자열이 모두 정확하게 일치하거나
  • 쿼리의 관계 문자열이 비어 있거나 누락되었습니다.

예: 관계가 delegate_permission/common.handle_all_urls인 쿼리가 애셋 링크가 관계 delegate_permission/common.handle_all_urls와 일치합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

List 호출에 대한 응답 메시지입니다.

JSON 표현 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
필드 이름 유형 설명
statements[] object(Statement) 발견된 모든 일치하는 문 목록입니다.
maxAge string

제공 시간으로부터 응답이 유효한 업데이트로 간주되어야 하는 기간을 나타냅니다. REQUIRED

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").
debugString string

최종 사용자가 결과를 이해하고 재현하고 디버그하는 데 도움이 되는 정보를 포함하고 있으며 사람이 읽을 수 있는 메시지입니다.

메시지는 영어로 제공되며 현재 Google에서는 번역을 제공할 계획이 없습니다.

이 문자열의 내용이나 형식은 보장되지 않습니다. 또한 일부 사항은 예고 없이 변경될 수 있습니다. 이 데이터를 프로그래매틱 방식으로 파싱하려고 해서는 안 됩니다. 필요한 정보가 API를 통해 노출되지 않기 때문에 이 작업을 수행해야 한다고 생각되면 먼저 Google에 문의해 주세요.

문

소스 애셋과 타겟 애셋 간의 관계에 대해 신뢰할 수 있는 문장을 설명합니다.

문은 항상 소스 애셋에 의해 만들어지며, 직접 또는 다른 곳에 저장된 문 목록을 위임하기도 합니다.

명세서와 애셋에 관한 자세한 정의는 API 문서 방문 페이지를 참고하세요.

JSON 표현 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
필드 이름 유형 설명
source object(Asset) 모든 문에는 소스 애셋이 있습니다. REQUIRED
relation string

관계는 소스 애셋의 소유자 (즉, 명세서를 발급한 사람 또는 법인)가 의도한 대로 명세서의 사용을 식별합니다. 모든 완전한 문에는 관계가 있습니다.

<kind>/<detail> 형식의 문자열과 관계를 식별합니다. 여기서 <kind>는 사전 정의된 목적 카테고리 집합 중 하나여야 하고, <detail>는 문의 특정 사용 사례를 설명하는 자유 형식의 소문자 영숫자 문자열입니다.

현재 지원되는 관계 목록은 API 문서를 참고하세요.

예: delegate_permission/common.handle_all_urls 필수
target object(Asset) 모든 문에는 타겟 애셋이 있습니다. REQUIRED

사용해 보기

API 탐색기를 사용하여 실시간 데이터에서 이 메서드를 호출하고 응답을 확인하세요.