Method statements.list

Mengambil daftar semua pernyataan dari sumber tertentu yang cocok dengan string pernyataan dan target yang ditentukan.

API menjamin bahwa semua pernyataan dengan aset sumber yang aman, seperti situs HTTPS atau aplikasi Android, dibuat dengan cara yang aman oleh pemilik aset tersebut, seperti yang dijelaskan dalam spesifikasi desain teknis Digital Asset Links. Secara khusus, Anda harus mempertimbangkan bahwa untuk situs yang tidak aman (yaitu, dengan URL yang diawali dengan http:// bukan https://), jaminan ini tidak dapat diberikan.

Perintah List paling berguna jika klien API ingin mengetahui semua cara keterkaitan dua aset, atau menghitung semua hubungan dari aset sumber tertentu. Contoh: fitur yang membantu pengguna membuka item terkait. Saat aplikasi seluler berjalan di perangkat, fitur tersebut akan memudahkan Anda untuk menavigasi ke situs web atau profil Google+ yang sesuai.

Permintaan HTTP

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

Parameter kueri

Nama parameter Jenis Deskripsi
source object(Asset) Sumber yang menghosting daftar laporan. Ini digunakan untuk mengarahkan permintaan List() ke sumber yang tepat. WAJIB
relation string

Hanya gunakan pengaitan yang cocok dengan relasi yang ditentukan.

Lihat pesan Statement untuk mengetahui definisi mendetail string relasi.

Agar kueri cocok dengan pernyataan, salah satu hal berikut harus benar:

  • baik {i>string<i} relasi di kueri maupun pernyataan sama persis, atau
  • {i>string<i} relasi kueri kosong atau hilang.

Contoh: Kueri dengan relasi delegate_permission/common.handle_all_urls cocok dengan link aset dengan relasi delegate_permission/common.handle_all_urls.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk panggilan Daftar.

Representasi JSON
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Nama kolom Jenis Deskripsi
statements[] object(Statement) Daftar semua pernyataan yang cocok yang telah ditemukan.
maxAge string

Mulai dari waktu penayangan, berapa lama lagi respons akan dianggap valid dengan membatasi update lebih lanjut. WAJIB

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

debugString string

Pesan yang dapat dibaca manusia berisi informasi yang dimaksudkan untuk membantu pengguna akhir memahami, mereproduksi, dan men-debug hasil.

Pesan tersebut akan menggunakan bahasa Inggris dan saat ini kami tidak berencana menawarkan terjemahan apa pun.

Perlu diketahui bahwa tidak ada jaminan yang dibuat terkait konten atau format string ini. Aspek apa pun dari konten tersebut dapat berubah tanpa pemberitahuan. Anda tidak boleh mencoba mengurai data ini secara terprogram. Jika Anda merasa perlu melakukan hal ini karena informasi yang Anda butuhkan tidak diekspos oleh API, hubungi kami terlebih dahulu.

Pernyataan

Menjelaskan pernyataan andal yang telah dibuat tentang hubungan antara aset sumber dan aset target.

Pernyataan selalu dibuat oleh aset sumber, baik secara langsung maupun dengan mendelegasikan ke daftar pernyataan yang disimpan di tempat lain.

Untuk definisi yang lebih mendetail tentang laporan mutasi dan aset, lihat halaman landing dokumentasi API kami.

Representasi JSON
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Nama kolom Jenis Deskripsi
source object(Asset) Setiap pernyataan memiliki aset sumber. WAJIB
relation string

Relasi mengidentifikasi penggunaan pernyataan sebagaimana mestinya oleh pemilik aset sumber (yaitu, orang atau entitas yang menerbitkan pernyataan tersebut). Setiap pernyataan yang lengkap memiliki hubungan.

Kami mengidentifikasi hubungan dengan string format <kind>/<detail>, dengan <kind> harus berupa salah satu dari kumpulan kategori tujuan yang ditentukan sebelumnya, dan <detail> adalah string alfanumerik huruf kecil bentuk bebas yang menjelaskan kasus penggunaan spesifik pernyataan.

Lihat dokumentasi API kami untuk mengetahui daftar relasi yang didukung saat ini.

Contoh: delegate_permission/common.handle_all_urls REQUIRED

target object(Asset) Setiap pernyataan memiliki aset target. WAJIB

Cobalah!

Gunakan APIs Explorer untuk memanggil metode ini pada data langsung dan melihat responsnya.