Sintaksis Daftar Pernyataan

Daftar pernyataan adalah file atau cuplikan yang berenkode JSON di lokasi yang terkenal.

Lokasi daftar pernyataan

Lihat Membuat daftar pernyataan untuk mempelajari tempat penyimpanan daftar ini.

Sintaksis

Daftar pernyataan atau cuplikan terdiri dari array JSON dari satu atau beberapa pernyataan situs atau aplikasi sebagai objek JSON. Pernyataan ini dapat dalam urutan apa pun. Berikut adalah sintaksis umum:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

hubungan

Array satu atau beberapa string yang menjelaskan hubungan yang dideklarasikan tentang target. Lihat daftar string relasi yang ditentukan. Contoh: delegate_permission/common.handle_all_urls

target

Aset target yang menerapkan pernyataan ini. Jenis target yang tersedia:

• Target situs

  "target": {
    "namespace": "web",
    "site": "site_root_url"
  }

  namespace

  Harus web untuk situs.

  situs

  URI situs yang merupakan target pernyataan, dalam format http[s]://<hostname>[:<port>], dengan <hostname> sepenuhnya memenuhi syarat, dan <port> harus dihilangkan saat menggunakan port 80 untuk HTTP, atau port 443 untuk HTTPS. Target situs web hanya boleh berupa domain root; Anda tidak dapat membatasi ke subdirektori tertentu; semua direktori pada root ini akan cocok. Subdomain tidak boleh dianggap cocok: yaitu, jika file pernyataan dihosting di www.example.com, maka www.puppies.example.com tidak boleh dianggap cocok. Untuk aturan dan contoh tentang pencocokan target situs, lihat dokumentasi target. Contoh: http://www.example.com

• Target aplikasi Android

  "target": {
    "namespace": "android_app",
    "package_name": "fully_qualified_package_name",
    "sha256_cert_fingerprints": ["cert_fingerprint"]
  }

  namespace

  Harus android_app untuk aplikasi Android.

  nama_paket

  Nama paket aplikasi yang sepenuhnya memenuhi syarat tempat pernyataan ini berlaku. Contoh: com.google.android.apps.maps

  sha256_cert_fingerprints

  Sidik jari SHA265 huruf besar pada sertifikat untuk aplikasi yang menerapkan pernyataan ini. Anda dapat menghitungnya menggunakan openssl atau keytool Java seperti yang ditunjukkan di sini:

  • openssl x509 -in $CERTFILE -noout -fingerprint -sha256
  • keytool -printcert -file $CERTFILE | grep SHA256

  Contoh: ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"].

  Jika Anda menggunakan Penandatanganan Aplikasi Play untuk aplikasi Anda, sidik jari sertifikat yang dihasilkan dengan menjalankan keytool atau openssl secara lokal biasanya tidak cocok dengan sidik jari yang ada di perangkat pengguna. Anda dapat memverifikasi apakah Anda menggunakan Penandatanganan Aplikasi Play untuk aplikasi di akun developer Konsol Play di bagian Release > Setup > App Integrity; jika demikian, Anda juga akan menemukan cuplikan JSON Digital Asset Links yang benar untuk aplikasi Anda di halaman yang sama.

Contoh daftar pernyataan

Berikut adalah contoh daftar pernyataan situs yang berisi pernyataan tentang situs dan aplikasi: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Melakukan penskalaan ke puluhan pernyataan atau lebih

Dalam beberapa kasus, akun utama mungkin ingin membuat banyak pernyataan yang berbeda tentang target yang berbeda, atau mungkin perlu mengeluarkan pernyataan dari akun utama yang berbeda ke kumpulan target yang sama. Misalnya, situs mungkin tersedia di berbagai Domain Level Teratas per-negara, dan semuanya mungkin ingin membuat pernyataan tentang aplikasi seluler yang sama.

Untuk situasi ini, menyertakan pernyataan dapat membantu. Dengan mekanisme ini, Anda dapat menyiapkan pointer dari berbagai akun utama yang berbeda ke satu lokasi pusat, yang akan menentukan pernyataan untuk semua akun utama.

Catatan: Maksimum 10 pernyataan penyertaan diizinkan dalam hierarki daftar pernyataan yang lengkap. Artinya, jumlah maksimum file di hierarki adalah: (10 file pernyataan yang disertakan) + (file pernyataan root) = 11 total.

Misalnya, Anda mungkin memutuskan bahwa lokasi pusat harus berupa `https://example.com/includedRepresentations.json`. File ini dapat dikonfigurasi untuk memuat konten yang sama seperti dalam contoh di atas.

Untuk menyiapkan pointer dari situs web ke file yang disertakan, ubah `https://example.com/.well-known/assetlinks.json` menjadi:

[{
  "include": "https://example.com/includedstatements.json"
}]

Untuk menyiapkan pointer dari aplikasi Android ke file yang disertakan, ubah `res/values/strings.xml` menjadi:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

Info Selengkapnya

Tersedia penjelasan yang lebih mendetail terkait format daftar pernyataan dan konsep yang mendasari dalam dokumen spesifikasi kami.