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( |
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 Agar kueri cocok dengan pernyataan, salah satu hal berikut harus benar:
Contoh: Kueri dengan relasi |
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( |
Nama kolom | Jenis | Deskripsi |
---|---|---|
statements[] |
object( |
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 ' |
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( |
Nama kolom | Jenis | Deskripsi |
---|---|---|
source |
object( |
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 Lihat dokumentasi API kami untuk mengetahui daftar relasi yang didukung saat ini. Contoh: |
target |
object( |
Setiap pernyataan memiliki aset target. WAJIB |
Cobalah!
Gunakan APIs Explorer untuk memanggil metode ini pada data langsung dan melihat responsnya.