Sử dụng câu lệnh

Mỗi tuyên bố được thiết kế cho người tiêu dùng; tuyên bố của người tiêu dùng là người đọc và xác minh tuyên bố do người uỷ quyền đưa ra, sau đó hành động dựa trên tuyên bố đó. Cụ thể hơn, người tiêu dùng thực hiện những bước cơ bản sau:

1. Yêu cầu danh sách bảng sao kê từ một người dùng cụ thể
2. Kiểm tra xem danh sách có chứa một tuyên bố nào đối với một mục tiêu nhất định hay không
3. Xác thực rằng mục tiêu trong câu lệnh là mục tiêu (trang web hoặc ứng dụng) mà bạn nghĩ là mục tiêu đó
4. Thực hiện hành động được chỉ định bởi câu lệnh nếu bạn chọn

Nhiều trường hợp sử dụng sử dụng câu lệnh cho bạn đằng sau. Ví dụ: tính năng Liên kết ứng dụng Android sử dụng các tuyên bố quyền liên kết do một trang web đưa ra để cho phép truy cập trực tiếp đường liên kết vào một ứng dụng. Một ứng dụng cho biết rằng ứng dụng đồng ý là mục tiêu của những câu lệnh như vậy bằng cách thêm mã đặc biệt (trình xử lý ý định) vào tệp kê khai.

Hãy nhớ kiểm tra để chắc chắn rằng trường hợp của bạn không có cơ chế đặc biệt để sử dụng hoặc triển khai câu lệnh trước khi xử lý theo cách thủ công.

Bạn có thể thực hiện bước 1 và 2 ở trên – yêu cầu và xác thực một câu lệnh – theo hai cách: sử dụng API của chúng tôi hoặc theo cách thủ công (sử dụng cách triển khai của riêng bạn).

Sử dụng câu lệnh bằng Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số)

Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số) hỗ trợ 2 phương thức: Check() và List() để tìm hoặc xác thực tuyên bố:

• Check() lấy nguồn, mục tiêu và mối quan hệ, đồng thời xác minh rằng nguồn đó đưa ra tuyên bố đã gửi về mục tiêu.
• List() liệt kê tất cả câu lệnh do một nguồn nhất định đưa ra.

Để sử dụng API này, bạn cần có khoá API và trước tiên, bạn phải kích hoạt API đó cho dự án của mình. Để thực hiện, hãy làm theo các bước sau:

1. Truy cập Google Developers Console.

   Bảng điều khiển có thể yêu cầu bạn đăng nhập trước.

2. Chọn hoặc tạo một dự án.

   Nếu bạn có nhiều dự án, hãy đảm bảo rằng bạn đang ở trong dự án mà bạn muốn kích hoạt Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số) rồi nhấp vào Continue (Tiếp tục). Hoặc nếu bạn chưa có dự án, hãy chọn Tạo dự án mới rồi nhấp vào Tạo.

3. Trong phần tổng quan về Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số), hãy nhấp vào Bật API.

   Nếu dự án của bạn đã được bật API, bạn sẽ thấy Tắt API.

4. Trên trình đơn bên trái, hãy nhấp vào Credentials (Thông tin xác thực) rồi chọn hoặc tạo một khoá API.

   Thông tin thêm về cách tạo khoá API.

Sử dụng câu lệnh theo cách thủ công

Giao thức Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số) đang mở nên bạn có thể tự triển khai.

Để sử dụng các câu lệnh do trang web đưa ra, bạn có thể tạo yêu cầu HTTP GET cho danh sách câu lệnh tương ứng và tự phân tích cú pháp. Ví dụ: danh sách câu lệnh tương ứng cho trang web http://example.digitalassetlinks.org là tại http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Để sử dụng các câu lệnh do ứng dụng Android đưa ra, bạn cần truy cập vào tệp kê khai của gói APK tương ứng. Trên thiết bị Android, bạn có thể thực hiện việc này bằng cách sử dụng giao diện PackageManager.

Vui lòng đặc biệt chú ý đến ý nghĩa cụ thể của các câu lệnh của Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số). Hãy tham khảo Quy cách về đường liên kết đến tài sản nếu bạn không chắc chắn.