Method assetlinks.check

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(Asset) 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 <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.

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

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

target object(Asset) 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 '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.

Cobalah!

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