문 사용

모든 문은 소비자를 염두에 두고 설계되었습니다. 문 소비자는 주 구성원이 작성한 문을 읽고 확인한 후 이 진술에 따라 조치를 취하는 사람입니다. 구체적으로 소비자는 다음과 같은 기본 단계를 수행합니다.

1. 특정 주 구성원의 문 목록 요청
2. 목록에 지정된 타겟과 관련하여 지정된 문이 포함되어 있는지 확인합니다.
3. 문장의 타겟이 여러분이 생각하는 타겟 (웹사이트 또는 앱)인지 검증합니다.
4. 원하는 경우 문에서 지정한 작업을 수행합니다.

많은 사용 사례에서 백그라운드에서 문을 사용합니다. 예를 들어, Android 앱 연결은 웹사이트에서 작성한 링크 권한 문을 사용하여 앱으로 직접 연결되는 링크를 사용 설정할 수 있습니다. 앱은 매니페스트에 특수 코드 (인텐트 핸들러)를 추가하여 그러한 모든 문의 대상이 되는 데 동의함을 나타냅니다.

문을 수동으로 처리하기 전에 시나리오에 명령문을 사용하거나 구현하기 위한 특별한 메커니즘이 없는지 확인하세요.

위의 1단계와 2단계(명령문 요청 및 검증)는 API를 사용하거나 수동으로(자체 구현 사용) 두 가지 방법으로 수행할 수 있습니다.

Digital Asset Links API를 사용하여 문 사용

Digital Asset Links API는 문을 찾거나 확인하는 두 가지 메서드인 Check() 및 List()를 지원합니다.

• Check()는 소스, 타겟, 관계를 취하여 소스가 대상에 대해 제출된 문을 작성하는지 확인합니다.
• List()는 지정된 소스에서 작성한 모든 문을 나열합니다.

API를 사용하려면 API 키가 필요하며 먼저 프로젝트에서 API를 활성화해야 합니다. 방법은 다음과 같습니다.

1. Google Developers Console로 이동합니다.

   콘솔에서는 먼저 로그인해야 할 수 있습니다.

2. 프로젝트를 선택하거나 만듭니다.

   프로젝트가 여러 개인 경우 Digital Asset Links API를 활성화할 프로젝트에 있는지 확인하고 계속을 클릭합니다. 또는 프로젝트가 없는 경우 새 프로젝트 만들기를 선택하고 만들기를 클릭합니다.

3. Digital Asset Links API 개요에서 API 사용 설정을 클릭합니다.

   프로젝트에서 API가 이미 사용 설정된 경우 API 사용 중지가 표시됩니다.

4. 왼쪽 메뉴에서 사용자 인증 정보를 클릭하고 API 키를 선택하거나 만듭니다.

   API 키 만들기에 대해 자세히 알아보기

수동으로 문 사용

디지털 애셋 링크 프로토콜은 공개되어 있으므로 직접 구현할 수 있습니다.

웹사이트의 문을 사용하려면 해당 문 목록에 대해 HTTP GET 요청을 실행하고 직접 파싱하면 됩니다. 예를 들어 http://example.digitalassetlinks.org 웹사이트에 해당하는 명령문 목록은 http://example.digitalassetlinks.org/.well-known/assetlinks.json에 있습니다.

Android 앱의 문을 사용하려면 해당하는 APK 패키지의 매니페스트에 액세스해야 합니다. Android 기기에서는 PackageManager 인터페이스를 사용하여 이 작업을 실행할 수 있습니다.

디지털 애셋 링크 구문의 구체적인 의미에 특히 주의하세요. 확실하지 않은 경우 애셋 링크 사양을 참조하세요.