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

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

메시지는 영어로 제공되며 현재는 번역이 제공되지 않을 예정입니다.

이 문자열의 콘텐츠 또는 형식은 보장되지 않습니다. 이러한 요소의 모든 부분은 예고 없이 변경될 수 있습니다. 이 데이터를 프로그래매틱 방식으로 파싱하려고 해서는 안 됩니다. 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 REQUIRED
target object(Asset) 모든 명세서에는 타겟 애셋이 있습니다. REQUIRED

사용해 보기

API Explorer에서 실제 데이터에 대해 이 메서드를 호출하여 응답을 확인해 보세요.