Method assetlinks.check

Menentukan apakah hubungan (arah) yang ditentukan ada antara aset sumber dan target yang ditentukan.

Hubungan menjelaskan maksud dari penautan antara dua aset seperti yang diklaim oleh aset sumber. Contoh untuk hubungan tersebut adalah delegasi hak istimewa atau izin.

Perintah ini paling sering digunakan oleh sistem infrastruktur untuk memeriksa prasyarat untuk melakukan tindakan. Misalnya, klien mungkin ingin mengetahui apakah tidak masalah untuk mengirim URL web ke aplikasi seluler tertentu. Klien dapat memeriksa link aset yang relevan dari situs ke aplikasi seluler untuk menentukan apakah operasi harus diizinkan atau tidak.

Catatan tentang keamanan: jika Anda menentukan aset aman sebagai sumber, seperti situs HTTPS atau aplikasi Android, API akan memastikan semua pernyataan yang digunakan untuk menghasilkan respons dibuat dengan cara yang aman oleh pemilik aset tersebut. Sebaliknya, jika aset sumber adalah situs HTTP yang tidak aman (yaitu, URL dimulai dengan http:// bukan https://), API tidak dapat memverifikasi pernyataannya dengan aman, dan tidak dapat memastikan bahwa pernyataan situs telah diubah oleh pihak ketiga. Untuk informasi selengkapnya, lihat spesifikasi desain teknis Digital Asset Links.

Permintaan HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Parameter kueri

Nama parameter Jenis Deskripsi
source object(Asset) Sumber yang menghosting daftar pernyataan. Ini digunakan untuk merutekan panggilan Check() ke sumber yang tepat.
relation string

String kueri untuk relasi.

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.

Agar kueri cocok dengan link aset, string relasi link kueri dan link aset harus sama persis.

Contoh: Kueri dengan relasi delegate_permission/common.handle_all_urls cocok dengan link aset terkait relasi delegate_permission/common.handle_all_urls.
target object(Asset) Aset target dari pernyataan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk panggilan CheckAssetLinks.

Representasi JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Nama kolom Jenis Deskripsi
linked boolean Tetapkan ke true jika aset yang ditentukan dalam permintaan ditautkan oleh relasi yang ditentukan dalam permintaan. WAJIB DIISI
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.

Cobalah!

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