Method assetlinks.check

Xác định xem có tồn tại mối quan hệ (hướng) đã chỉ định giữa tài sản nguồn và tài sản mục tiêu đã chỉ định hay không.

Mối quan hệ này mô tả ý định của mối liên kết giữa hai tài sản theo thông báo xác nhận quyền sở hữu của tài sản nguồn. Một ví dụ về những mối quan hệ như vậy là việc uỷ quyền đặc quyền hoặc quyền.

Hệ thống cơ sở hạ tầng thường sử dụng lệnh này để kiểm tra các điều kiện tiên quyết cho một hành động. Ví dụ: khách hàng có thể muốn biết liệu họ có thể gửi URL web đến một ứng dụng dành cho thiết bị di động cụ thể hay không. Khách hàng có thể kiểm tra đường liên kết đến thành phần liên quan từ trang web đến ứng dụng di động để quyết định xem có nên cho phép hoạt động này hay không.

Lưu ý về bảo mật: nếu bạn chỉ định một tài sản bảo mật làm nguồn, chẳng hạn như một trang web HTTPS hoặc một ứng dụng Android, thì API sẽ đảm bảo rằng chủ sở hữu tài sản đó đã đưa ra các câu lệnh dùng để tạo phản hồi. Ngược lại, nếu tài sản nguồn là một trang web HTTP không an toàn (tức là URL bắt đầu bằng http:// thay vì https://), API không thể xác minh các câu lệnh một cách an toàn và không thể đảm bảo rằng các câu lệnh của trang web không bị bên thứ ba thay đổi. Để biết thêm thông tin, hãy xem quy cách thiết kế kỹ thuật của Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số).

Yêu cầu HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Tham số truy vấn

Tên thông số Loại Mô tả
source object(Asset) Nguồn lưu trữ danh sách câu lệnh. Thông tin này được dùng để chuyển lệnh gọi Check() đến nguồn thích hợp.
relation string

Chuỗi truy vấn cho mối quan hệ.

Chúng tôi xác định mối quan hệ với các chuỗi có định dạng <kind>/<detail>, trong đó <kind> phải là một trong các tập hợp danh mục mục đích được xác định trước và <detail> là một chuỗi ký tự chữ-số viết tự do mô tả trường hợp sử dụng cụ thể của câu lệnh.

Tham khảo tài liệu về API của chúng tôi để biết danh sách các mối quan hệ được hỗ trợ hiện tại.

Để một cụm từ tìm kiếm khớp với một đường liên kết đến tài sản, cả chuỗi quan hệ của cụm từ tìm kiếm đó và chuỗi đường liên kết đến tài sản đều phải khớp chính xác.

Ví dụ: Một truy vấn có mối quan hệ delegate_permission/common.handle_all_urls khớp với một đường liên kết tài sản có mối quan hệ delegate_permission/common.handle_all_urls.
target object(Asset) Thành phần mục tiêu của câu lệnh.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho lệnh gọi CheckAssetLink.

Biểu diễn dưới dạng JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Tên trường Loại Mô tả
linked boolean Đặt thành true nếu các thành phần được chỉ định trong yêu cầu được liên kết bằng mối quan hệ được chỉ định trong yêu cầu. BẮT BUỘC
maxAge string

Kể từ thời gian phân phát, thời hạn phản hồi sẽ được coi là hợp lệ nếu không được cập nhật thêm. BẮT BUỘC

Thời lượng tính bằng giây có tối đa chín chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
debugString string

Thông báo mà người dùng có thể đọc được, chứa thông tin giúp người dùng cuối hiểu, mô phỏng và gỡ lỗi kết quả.

Thông báo này sẽ bằng tiếng Anh và chúng tôi hiện không dự định cung cấp bản dịch.

Xin lưu ý rằng chúng tôi không đảm bảo về nội dung hay định dạng của chuỗi này. Mọi khía cạnh của dữ liệu này có thể thay đổi mà không cần thông báo trước. Bạn không nên tìm cách phân tích cú pháp dữ liệu này theo phương thức lập trình. Nếu bạn cảm thấy cần phải làm điều này vì thông tin bạn cần không bị API tiết lộ, trước tiên, vui lòng liên hệ với chúng tôi.

Hãy dùng thử!

Hãy sử dụng API Explorer để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.