Method assetlinks.check

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

Mối quan hệ mô tả mục đích liên kết giữa hai tài sản như đã được tài sản nguồn xác nhận quyền sở hữu. Một ví dụ cho các mối quan hệ như vậy là việc uỷ quyền đặc quyền hoặc cấp quyền.

Lệnh này thường được các hệ thống cơ sở hạ tầng sử dụng để kiểm tra các điều kiện tiên quyết cho một hành động. Ví dụ: một khách hàng có thể muốn biết liệu có nên gửi URL web đến một ứng dụng 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 có liên quan từ trang web đến ứng dụng di động để quyết định xem có cho phép hoạt động này hay không.

Lưu ý về tính bảo mật: nếu bạn chỉ định một thành phầ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 mọi câu lệnh dùng để tạo phản hồi đều được chủ sở hữu của tài sản đó đưa ra một cách an toàn. Ngược lại, nếu thành phần nguồn là một trang web HTTP không bảo mật (tức là URL bắt đầu bằng http:// thay vì https://), thì API không thể xác minh các tuyên bố của trang web một cách an toàn và không thể đảm bảo rằng các tuyên bố 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 Đườ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 Nội dung mô tả
source object(Asset) Nguồn lưu trữ danh sách bảng sao kê. Mã này dùng để định tuyến lệnh gọi Check() đến nguồn phù hợp.
relation string

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

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

Hãy 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 truy vấn khớp với đường liên kết tài sản, chuỗi quan hệ của cụm từ tìm kiếm và đường liên kết tài sản phải khớp chính xác.

Ví dụ: Truy vấn có quan hệ delegate_permission/common.handle_all_urls khớp với một đường liên kết đến tài sản có 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 cuộc gọi CheckAssetLinks.

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

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

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

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

Thông báo này sẽ bằng tiếng Anh và hiện tại chúng tôi không có kế hoạch 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 hoặc định dạng của chuỗi này. Bất kỳ khía cạnh nào của nội dung có thể thay đổi mà không cần thông báo. 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 thấy cần phải làm việc này vì thông tin bạn cần không được API hiển thị, vui lòng liên hệ trước với chúng tôi.

Hãy dùng thử!

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