이 페이지는 Cloud Translation API를 통해 번역되었습니다.

문 목록 구문

명세 목록은 잘 알려진 위치에 있는 JSON 인코딩 파일 또는 스니펫입니다.

명령문 목록의 위치

이 목록을 저장해야 하는 위치는 명령문 목록 만들기를 참고하세요.

구문

명세 목록 또는 스니펫은 하나 이상의 웹사이트 또는 앱 명세가 JSON 객체로 구성된 JSON 배열로 구성됩니다. 이러한 문은 순서에 관계없이 작성할 수 있습니다. 일반적인 구문은 다음과 같습니다.

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

relation

타겟에 관해 선언되는 관계를 설명하는 하나 이상의 문자열 배열입니다. 정의된 관계 문자열 목록을 참고하세요. 예: delegate_permission/common.handle_all_urls

target

이 문이 적용되는 타겟 애셋입니다. 사용 가능한 타겟 유형:

웹사이트 타겟
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
네임스페이스

웹사이트의 경우 web이어야 합니다.

사이트
http[s]://<hostname>[:<port>] 형식의 선언 대상 사이트의
URI입니다. 여기서 <hostname>는 정규화되어야 하며, HTTP에 포트 80을 사용하거나 HTTPS에 포트 443을 사용할 때는 <port>를 생략해야 합니다. 웹사이트 타겟은 루트 도메인만 될 수 있으며 특정 하위 디렉터리로 제한할 수 없습니다. 이 루트 아래의 모든 디렉터리가 일치합니다. 하위 도메인은 일치하는 것으로 간주하지 않습니다. 즉, 문장 파일이 www.example.com에 호스팅된 경우 www.puppies.example.com은 일치하는 것으로 간주하지 않습니다. 웹사이트 타겟 매칭에 관한 규칙과 예시는 타겟 문서를 참고하세요. 예: http://www.example.com
Android 앱 타겟
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
네임스페이스

Android 앱의 경우 android_app이어야 합니다.

package_name

이 문장이 적용되는 앱의 정규화된 패키지 이름입니다. 예: com.google.android.apps.maps

sha256_cert_fingerprints
이 문이 적용되는 앱의 인증서에 대한 대문자 SHA256 지문입니다.
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
예: ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
앱에 Play 앱 서명을 사용 중인 경우 로컬에서 keytool 또는 openssl를 실행하여 생성된 인증서 지문은 일반적으로 사용자 기기의 인증서 지문과 일치하지 않습니다. Play Console 개발자 계정의 Release > Setup > App Integrity에서 앱에 Play 앱 서명을 사용하고 있는지 확인할 수 있습니다. 사용하고 있다면 같은 페이지에서 앱에 적합한 디지털 애셋 링크 JSON 스니펫도 확인할 수 있습니다.

relation_extensions (선택사항)

선택사항인 relation_extensions 필드를 문에 추가하여 부여하려는 권한 및 연결에 관한 자세한 정보를 제공할 수 있습니다. 이 필드는 각 키가 관계 문자열이고 값이 해당 관계의 확장 프로그램을 포함하는 객체인 객체여야 합니다. 이러한 명세서를 요청하는 클라이언트는 이러한 필드를 준수하도록 업데이트해야 합니다.

예를 들어 delegate_permission/common.handle_all_urls 관계의 relation_extensions는 다음과 같을 수 있습니다.

  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.app",
      "sha256_cert_fingerprints": ["..."]
    },
    "relation_extensions": {
      "delegate_permission/common.handle_all_urls": {...}
    }
  }

DAL API는 요청에 return_relation_extensions=true 매개변수가 설정된 경우 API 호출에서 relation_extensions 반환을 지원합니다.

예시 문장 목록

웹사이트와 앱에 관한 명령문이 모두 포함된 웹사이트 명령문 목록의 예는 다음과 같습니다. http://example.digitalassetlinks.org/.well-known/assetlinks.json

수십 개 이상의 문으로 확장

경우에 따라 주 구성원이 여러 타겟에 관해 다양한 문을 작성할 수 있으며, 여러 주 구성원이 동일한 타겟 집합에 관해 문을 발급해야 할 수도 있습니다. 예를 들어 웹사이트가 여러 국가별 최상위 도메인에서 제공될 수 있으며, 이들 모두 동일한 모바일 앱에 관한 설명을 제공할 수 있습니다.

이러한 상황에서는 include statements가 유용할 수 있습니다. 이 메커니즘을 사용하면 여러 주체에서 모든 주체의 명령문을 정의하는 하나의 중앙 위치로 포인터를 설정할 수 있습니다.

예를 들어 중앙 위치가 `https://example.com/includedstatements.json`이라고 결정할 수 있습니다. 이 파일은 위의 예와 동일한 콘텐츠를 포함하도록 구성할 수 있습니다.

웹사이트에서 include 파일로 포인터를 설정하려면 `https://example.com/.well-known/assetlinks.json` 을 다음과 같이 변경합니다.

[{
  "include": "https://example.com/includedstatements.json"
}]

Android 앱에서 include 파일로 포인터를 설정하려면 `res/values/strings.xml` 을 다음과 같이 변경합니다.

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

추가 정보

명세서 목록 형식과 기본 개념에 관한 자세한 설명은 사양 문서를 참고하세요.