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 mục tiêu và chuỗi câu lệnh được chỉ định.

API đảm bảo rằng tất cả các bảng sao kê 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 tài sản tạo ra một cách an toàn, như mô tả trong thông số kỹ thuật thiết kế kỹ thuật cho Đường liên kết đến tài sản kỹ thuật số. Cụ thể là bạn nên cân nhắc việc đảm bảo các trang web không an toàn (tức là các URL bắt đầu bằng http:// thay vì https://).

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ách liên quan đến hai tài sản hoặc liệt kê tất cả mối quan hệ từ một tài sản nguồn cụ thể. Ví dụ: một tính năng giúp người dùng di chuyển đến các mục liên quan. Khi một ứng dụng dành cho thiết bị di động đang chạy trên một thiết bị, tính năng này sẽ giúp bạn dễ dàng điều hướng đến trang web tương ứng hoặc hồ sơ trên Google+.

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 Mô tả
source object(Asset) Nguồn lưu trữ danh sách câu lệnh. Thông tin 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 liên kết phù hợp với mối quan hệ được chỉ định.

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

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

  • cả chuỗi quan hệ của cụm từ tìm kiếm 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ụ: 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.

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 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 Mô tả
statements[] object(Statement) Danh sách tất cả câu lệnh phù hợp đã tìm thấy.
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.

Tuyên bố

Mô tả câu lệnh đáng tin cậy được đưa ra về mối quan hệ giữa tài sản nguồn và tài sản mục tiêu.

Những câu lệnh luôn được tạo bằng tài sản nguồn, trực tiếp hoặc bằng cách uỷ quyền cho một danh sách câu lệnh được lưu trữ ở nơi khác.

Để biết định nghĩa chi tiết hơn về bảng sao kê và tài sả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 Mô tả
source object(Asset) Mỗi câu lệnh đều có một tài sả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 chủ định của chủ sở hữu tài sản nguồn (tức là người hoặc pháp nhân đưa ra câu lệnh). Mỗi câu lệnh hoàn chỉnh đều có 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.

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

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.