Method statements.list

Truy xuất danh sách tất cả câu lệnh từ một nguồn nhất định khớp với chuỗi câu lệnh và mục tiêu đã chỉ định.

API này đảm bảo rằng tất cả câu lệnh có tài sản nguồn bảo mật (chẳng hạn như trang web HTTPS hoặc ứng dụng Android) đều đã được chủ sở hữu của những tài sản đó đưa ra một cách an toàn, theo mô tả trong 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ố). Cụ thể, bạn nên lưu ý rằng đối với các trang web không an toàn (tức là nơi URL bắt đầu bằng http:// thay vì https://), bạn không thể thực hiện đảm bảo này.

Lệnh List hữu ích nhất trong trường hợp ứng dụng API muốn biết tất cả các mối liên hệ giữa hai tài sản hoặc liệt kê tất cả các mối quan hệ từ một tài sản nguồn cụ thể. Ví dụ: tính năng giúp người dùng chuyển đến các mục có liên quan. Khi ứng dụng dành cho thiết bị di động đang chạy trên thiết bị, tính năng này sẽ giúp điều hướng dễ dàng đến trang web hoặc hồ sơ trên Google+ tương ứng.

Yêu cầu HTTP

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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ê. Hàm này dùng để chuyển yêu cầu List() đến đúng nguồn. BẮT BUỘC
relation string

Chỉ sử dụng các mối liên kết phù hợp với mối quan hệ đã chỉ định.

Hãy xem thông báo Statement để biết định nghĩa chi tiết về chuỗi quan hệ.

Để một truy vấn khớp với câu lệnh, một trong các điều kiện sau phải đúng:

  • cả chuỗi quan hệ của truy vấn và câu lệnh đều khớp chính xác, hoặc
  • chuỗi quan hệ của truy vấn bị trống hoặc bị thiếu.

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.

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:

Tin nhắn phản hồi cho cuộc gọi Danh sách.

Biểu diễn dưới dạng JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Tên trường Loại Nội dung mô tả
statements[] object(Statement) Danh sách tất cả câu lệnh trùng khớp đã được tìm thấy.
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.

Tuyên bố

Mô tả tuyên bố đáng tin cậy về mối quan hệ giữa nội dung nguồn và nội dung mục tiêu.

Nội dung tuyên bố luôn được tạo bởi nội dung nguồn, có thể là trực tiếp hoặc uỷ quyền cho một danh sách bảng sao kê được lưu trữ ở nơi khác.

Để biết định nghĩa chi tiết hơn về bảng sao kê và thành phần, vui lòng tham khảo trang đích của tài liệu API.

Biểu diễn dưới dạng JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Tên trường Loại Nội dung mô tả
source object(Asset) Mỗi câu lệnh đều có một thành phần nguồn. BẮT BUỘC
relation string

Mối quan hệ này xác định việc sử dụng câu lệnh theo dự định của chủ sở hữu nội dung nguồn (tức là cá nhân hoặc pháp nhân phát hành câu lệnh). Mỗi câu lệnh hoàn chỉnh đều có một 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.

Ví dụ: delegate_permission/common.handle_all_urls REQUIRED
target object(Asset) Mỗi câu lệnh đều có một thành phần mục tiêu. BẮT BUỘC

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.