Sử dụng câu lệnh

Mọi câu lệnh đều được thiết kế dành cho người tiêu dùng; câu lệnh người tiêu dùng là người đọc và xác minh câu lệnh do người dùng chính đưa ra, sau đó thực hiện hành động dựa trên câu lệnh đó. Cụ thể hơn, người tiêu dùng thực hiện các 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 chính cụ thể
2. Kiểm tra xem danh sách có chứa một câu lệnh cho trước 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 cho rằng
4. Thực hiện thao tác do câu lệnh chỉ định, nếu bạn chọn

Nhiều trường hợp sử dụng sử dụng câu lệnh trong nền. Ví dụ: Đường liên kết trong ứng dụng Android sử dụng các câu lệnh về quyền liên kết do một trang web tạo ra để bật trực tiếp các đường liên kết vào một ứng dụng. Ứng dụng cho biết ứng dụng đó đồng ý là mục tiêu của mọi 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 để đảm bảo 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 một 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 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 cách sử dụng API Digital Asset Links

Digital Asset Links API hỗ trợ hai phương thức: Check() và List() để tìm hoặc xác thực câu lệnh:

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

Để 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 này cho dự án của mình. Để thực hiện, hãy làm theo các bước sau:

1. Chuyển đến 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 tham gia dự án mà bạn muốn kích hoạt API Digital Asset Links (Đườ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 và nhấp vào Tạo.

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

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

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

   Tìm hiểu 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ở, vì vậy, bạn có thể tự triển khai giao thức này.

Để sử dụng những câu lệnh do các trang web tạo, bạn có thể tạo một 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à http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Để sử dụng những câu lệnh do các ứng dụng Android tạo, 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 Đường liên kết đến tài sản kỹ thuật số. Vui lòng xem Quy cách về đường liên kết đến tài sản nếu bạn không chắc chắn.