Setiap pernyataan dirancang dengan mempertimbangkan konsumen; konsumen pernyataan adalah orang yang membaca dan memverifikasi pernyataan yang dibuat oleh prinsipal, lalu mengambil tindakan berdasarkan pernyataan tersebut. Lebih spesifiknya, konsumen melakukan langkah-langkah dasar berikut:
- Meminta daftar pernyataan dari akun utama tertentu
- Periksa apakah daftar berisi pernyataan tertentu terhadap target tertentu
- Validasi bahwa target dalam pernyataan adalah target (situs atau aplikasi) yang menurut Anda
- Melakukan tindakan yang ditentukan oleh pernyataan, jika Anda memilih untuk
Banyak kasus penggunaan menggunakan pernyataan untuk Anda di balik layar. Misalnya, Penautan Aplikasi Android menggunakan pernyataan izin link yang dibuat oleh situs untuk mengaktifkan link langsung ke aplikasi. Aplikasi menunjukkan bahwa aplikasi tersebut setuju untuk menjadi target bagi pernyataan tersebut dengan menambahkan kode khusus (pengendali intent) dalam manifesnya.
Anda bisa melakukan langkah 1 dan 2 di atas — meminta dan memvalidasi pernyataan — dengan dua cara: menggunakan API kami atau secara manual (menggunakan implementasi Anda sendiri).
Memakai pernyataan menggunakan Digital Asset Links API
Digital Asset Links API mendukung dua metode: Check()
dan List()
untuk menemukan atau memvalidasi laporan:
Check()
mengambil sumber, target, dan hubungan, serta memverifikasi bahwa sumber membuat pernyataan yang dikirimkan tentang target.List()
mencantumkan semua pernyataan yang dibuat oleh sumber tertentu.
Menggunakan laporan secara manual
Protokol Digital Asset Links terbuka, sehingga Anda dapat membuat implementasinya sendiri.
Untuk menggunakan pernyataan yang dibuat oleh situs, Anda dapat membuat permintaan HTTP GET untuk daftar pernyataan terkait dan mengurainya sendiri. Misalnya, daftar laporan yang sesuai untuk situs http://example.digitalassetlinks.org
ada di http://example.digitalassetlinks.org/.well-known/assetlinks.json
.
Untuk menggunakan pernyataan yang dibuat oleh aplikasi Android, Anda perlu mengakses manifes paket APK yang sesuai. Di perangkat Android, hal ini dapat dilakukan menggunakan antarmuka PackageManager.
Harap perhatikan secara khusus arti spesifik dari pernyataan Digital Asset Links. Lihat Spesifikasi Link Aset jika Anda tidak yakin.