Method statements.list

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

API menjamin bahwa semua pernyataan dengan aset sumber yang aman, seperti situs HTTPS atau aplikasi Android, telah 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, jika URL diawali dengan http://, bukan https://), jaminan ini tidak dapat dibuat.

Perintah List paling berguna jika klien API ingin mengetahui semua cara yang menghubungkan 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 mempermudah navigasi 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 pernyataan. Ini digunakan untuk mengarahkan permintaan List() ke sumber yang tepat. WAJIB DIISI
relation string

Hanya gunakan atribusi yang cocok dengan relasi yang ditentukan.

Lihat pesan Statement untuk mengetahui definisi detail string relasi.

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

  • string relasi kueri dan pernyataan sama persis, atau
  • String relasi kueri kosong atau tidak ada.

Contoh: Kueri dengan relasi delegate_permission/common.handle_all_urls cocok dengan link aset terkait 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 List.

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

Dari waktu penayangan, berapa lama respons harus dianggap valid kecuali jika pembaruan lebih lanjut. WAJIB DIISI

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

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

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

Harap perhatikan bahwa tidak ada jaminan yang dibuat untuk konten atau format string ini. Aspek mana pun dapat berubah tanpa pemberitahuan. Anda tidak boleh mencoba mengurai data ini secara terprogram. Jika Anda merasa bahwa Anda harus melakukan hal ini karena informasi yang diperlukan 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 pernyataan dan aset, lihat halaman landing dokumentasi API.

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

Hubungan mengidentifikasi penggunaan laporan seperti yang diinginkan 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 merupakan salah satu dari kumpulan kategori tujuan yang telah ditentukan, dan <detail> adalah string alfanumerik huruf kecil bentuk bebas yang menjelaskan kasus penggunaan tertentu dari pernyataan tersebut.

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 DIISI

Cobalah!

Gunakan Explorer API untuk memanggil metode ini pada data live dan melihat respons.