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( |
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 Để truy vấn phù hợp với câu lệnh, một trong những điều sau phải đúng:
Ví dụ: Một truy vấn có mối quan hệ |
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( |
Tên trường | Loại | Mô tả |
---|---|---|
statements[] |
object( |
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 " |
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( |
Tên trường | Loại | Mô tả |
---|---|---|
source |
object( |
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 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ụ: |
target |
object( |
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.