Bu sayfa, Cloud Translation API ile çevrilmiştir.

İfade Listesi Söz Dizimi

Bildirim listesi, bilinen bir konumdaki JSON kodlu bir dosya veya snippet'tir.

Bildirim listesinin konumu

Bu listenin nerede saklanması gerektiğini öğrenmek için Bildirim listesi oluşturma başlıklı makaleyi inceleyin.

Söz dizimi

Bildirim listesi veya snippet'i, JSON nesneleri olarak bir veya daha fazla web sitesi ya da uygulama bildiriminin JSON dizisinden oluşur. Bu ifadeler herhangi bir sırada olabilir. Genel söz dizimi şöyledir:

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

relation

Hedef hakkında bildirilen ilişkiyi açıklayan bir veya daha fazla dizeden oluşan bir dizi. Tanımlanmış ilişki dizelerinin listesine bakın. Örnek: delegate_permission/common.handle_all_urls

hedef

Bu ifadenin geçerli olduğu hedef öğe. Kullanılabilir hedef türleri:

Web sitesi hedefi
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
ad alanı

Web siteleri için web olmalıdır.

site

Beyanın hedefi olan sitenin URI'si, http[s]://<hostname>[:<port>] biçiminde. Burada <hostname> tam nitelikli olmalı ve HTTP için 80 numaralı bağlantı noktası veya HTTPS için 443 numaralı bağlantı noktası kullanılırken <port> atlanmalıdır. Web sitesi hedefi yalnızca bir kök alan olabilir. Belirli bir alt dizinle sınırlama yapamazsınız. Bu kök altındaki tüm dizinler eşleşir. Alt alan adlarının eşleştiği kabul edilmemelidir. Yani, bildirim dosyası www.example.com adresinde barındırılıyorsa www.puppies.example.com eşleşme olarak kabul edilmemelidir. Web sitesi hedef eşleştirme ile ilgili kurallar ve örnekler için hedef dokümanlarına bakın. Örnek: http://www.example.com
Android uygulama hedefi
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
ad alanı
Android uygulamaları için
olmalıdırandroid_app.

package_name

Bu bildirimin geçerli olduğu uygulamanın tam nitelikli paket adı. Örnek: com.google.android.apps.maps

sha256_cert_fingerprints
Bu ifadenin geçerli olduğu uygulamanın sertifikasının büyük harfli SHA265 parmak izi. Bunu, burada gösterildiği gibi openssl veya Java keytool kullanarak hesaplayabilirsiniz:
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
Örnek: ["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"].
Uygulamanız için Play Uygulama İmzalama'yı kullanıyorsanız keytool veya openssl komutları yerel olarak çalıştırıldığında oluşturulan sertifika parmak izi genellikle kullanıcıların cihazlarındakiyle eşleşmez. Uygulamanız için Play Uygulama İmzalama'yı kullanıp kullanmadığınızı Play Console geliştirici hesabınızdaki Release > Setup > App Integrity bölümünde doğrulayabilirsiniz. Kullanıyorsanız uygulamanız için doğru Digital Asset Links JSON snippet'ini de aynı sayfada bulabilirsiniz.

relation_extensions (isteğe bağlı)

İzinler ve ilişkilendirmeler hakkında daha fazla bilgi vermek için bir ifadeye isteğe bağlı relation_extensions alanı ekleyebilirsiniz. Bu alan, her anahtarın bir ilişki dizesi olduğu ve değerin, bu ilişkiye ait uzantıları içeren bir nesne olduğu bir nesne olmalıdır. Bu ifadeleri isteyen istemcilerin, bu alanlara saygı duyacak şekilde güncellenmesi gerekir.

Örneğin, delegate_permission/common.handle_all_urls ilişkisi için relation_extensions şu şekilde görünebilir:

  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.app",
      "sha256_cert_fingerprints": ["..."]
    },
    "relation_extensions": {
      "delegate_permission/common.handle_all_urls": {...}
    }
  }

DAL API, istekte return_relation_extensions=true parametresi ayarlandığında API çağrılarında relation_extensions döndürülmesini destekler.

Örnek ifade listesi

Hem web siteleri hem de uygulamalarla ilgili ifadeler içeren örnek bir web sitesi ifadesi listesini burada bulabilirsiniz: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Onlarca veya daha fazla ekstreyi ölçeklendirme

Bazı durumlarda bir müdür, farklı hedefler hakkında birçok farklı açıklama yapmak isteyebilir veya aynı hedef grubuna farklı müdürlerden açıklamalar göndermek gerekebilir. Örneğin, bir web sitesi birçok farklı ülke bazlı üst düzey alan adında kullanılabilir ve bunların tümü aynı mobil uygulama hakkında açıklama yapmak isteyebilir.

Bu durumlarda include ifadeleri faydalı olabilir. Bu mekanizmayı kullanarak, birçok farklı asıl kişiden tek bir merkezi konuma işaretçiler ayarlayabilirsiniz. Bu merkezi konum, tüm asıl kişiler için ifadeleri tanımlar.

Örneğin, merkezi konumun "https://example.com/includedstatements.json" olması gerektiğine karar verebilirsiniz. Bu dosya, yukarıdaki örneklerdeki içerikle aynı olacak şekilde yapılandırılabilir.

Bir web sitesinden include dosyasına işaretçi ayarlamak için, `https://example.com/.well-known/assetlinks.json` ifadesini şu şekilde değiştirin:

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

Bir Android uygulamasından include dosyasına işaretçi ayarlamak için `res/values/strings.xml` dosyasını şu şekilde değiştirin:

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

Daha Fazla Bilgi

İfade listesi biçimi ve temel kavramlar hakkında daha ayrıntılı açıklamayı spesifikasyon belgemizde bulabilirsiniz.