Menentukan apakah ada hubungan yang ditentukan (arah) antara aset sumber dan target yang ditentukan.
Relasi menjelaskan maksud penautan antara kedua aset tersebut seperti yang diklaim oleh aset sumber. Contoh untuk hubungan tersebut adalah pendelegasian hak istimewa atau izin.
Perintah ini paling sering digunakan oleh sistem infrastruktur untuk memeriksa prasyarat untuk suatu tindakan. Misalnya, klien mungkin ingin tahu apakah URL web boleh dikirim ke aplikasi seluler tertentu sebagai gantinya. Klien dapat memeriksa link aset yang relevan dari situs ke aplikasi seluler untuk memutuskan apakah operasi harus diizinkan.
Catatan tentang keamanan: jika Anda menentukan aset aman sebagai sumbernya, seperti situs HTTPS atau aplikasi Android, API akan memastikan bahwa setiap pernyataan yang digunakan untuk menghasilkan respons telah dibuat dengan cara yang aman oleh pemilik aset tersebut. Sebaliknya, jika aset sumber adalah situs HTTP yang tidak aman (yaitu, URL dimulai dengan http://
dan bukan https://
), API tidak dapat memverifikasi pernyataannya secara aman, dan tidak mungkin memastikan bahwa pernyataan situs belum 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( |
Sumber yang menghosting daftar laporan. Ini digunakan untuk merutekan panggilan Check() ke sumber yang tepat. |
relation |
string |
String kueri untuk relasi. Kami mengidentifikasi hubungan dengan string format Lihat dokumentasi API kami untuk mengetahui daftar relasi yang didukung saat ini. Agar kueri cocok dengan link aset, string relasi di kueri dan link aset harus sama persis. Contoh: Kueri dengan relasi |
target |
object( |
Aset target 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 benar jika aset yang ditentukan dalam permintaan ditautkan oleh hubungan yang ditentukan dalam permintaan. WAJIB |
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. |
Cobalah!
Gunakan APIs Explorer untuk memanggil metode ini pada data langsung dan melihat responsnya.