Menggunakan pernyataan

Setiap pernyataan dirancang dengan mempertimbangkan konsumen; konsumen pernyataan adalah yang membaca dan memverifikasi pernyataan yang dibuat oleh prinsipal, lalu mengambil tindakan berdasarkan pernyataan tersebut. Secara lebih spesifik, konsumen melakukan langkah dasar berikut:

  1. Meminta daftar pernyataan dari akun utama tertentu
  2. Periksa untuk melihat apakah daftar berisi pernyataan yang diberikan terhadap target tertentu
  3. Validasikan bahwa target dalam pernyataan adalah target (situs atau aplikasi) yang menurut Anda merupakan
  4. Lakukan tindakan yang ditentukan oleh pernyataan, jika Anda memilih untuk

Banyak kasus penggunaan yang menggunakan pernyataan di balik layar untuk Anda. 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 dalam pernyataan tersebut dengan menambahkan kode khusus (pengendali intent) dalam manifesnya.

Anda dapat melakukan langkah 1 dan 2 di atas — meminta dan memvalidasi pernyataan — dengan dua cara: menggunakan API kami atau secara manual (menggunakan penerapan Anda sendiri).

Menggunakan pernyataan menggunakan Digital Asset Links API

Digital Asset Links API mendukung dua metode: Check() dan List() untuk menemukan atau memvalidasi pernyataan:

  • 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 mutasi secara manual

Protokol Link Aset Digital terbuka, sehingga Anda dapat menerapkannya sendiri.

Untuk menggunakan pernyataan yang dibuat oleh situs web, Anda dapat membuat permintaan HTTP GET untuk daftar pernyataan yang sesuai dan mengurainya sendiri. Misalnya, daftar pernyataan yang sesuai untuk situs web http://example.digitalassetlinks.org adalah di http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Untuk menggunakan pernyataan yang dibuat oleh aplikasi Android, Anda harus mengakses manifes paket APK yang sesuai. Di perangkat Android, hal ini dapat dilakukan menggunakan antarmuka PackageManager.

Perhatikan arti spesifik dari pernyataan Digital Asset Links. Lihat Spesifikasi Penautan Aset jika Anda tidak yakin.