Package google.digitalassetlinks.v1

Dizin

İfadeler

Bu API hizmeti "ifadeler" sunar. Bunlar, öğe sahipleri tarafından öğe bağlantıları hakkında bilgi yayınlamak için kullanılan araçlardır. API, ifadeleri doğrudan kaynaklardan almaya gerek kalmadan basit ve güvenli bir şekilde almak için kullanılabilir.

Bu API tarafından döndürülen tüm ifadeler, diğer dijital varlıklar hakkında dijital varlıklar (ör. web siteleri veya Android uygulamaları) adına yapılmıştır. Her ifade bir kaynak öğe, bir hedef öğe ve en az bir ilişki içerir.

İlişki, kaynak öğe tarafından hak talebinde bulunulan şekliyle iki öğe arasındaki ilişkiyi açıklar. Ayrıcalıkların veya izinlerin verilmesi bu tür ilişkilere bir örnektir.

Liste

rpc List(ListRequest) returns (ListResponse)

Belirli bir kaynaktan, belirtilen hedef ve ifade dizesiyle eşleşen tüm ifadelerin listesini alır.

API, HTTPS web siteleri veya Android uygulamaları gibi güvenli kaynak öğeleri içeren tüm ifadelerin, Digital Asset Links teknik tasarım spesifikasyonunda açıklandığı şekilde ilgili varlıkların sahibi tarafından güvenli bir şekilde hazırlandığını garanti eder. Özellikle, güvenli olmayan web siteleri (yani URL'nin https:// yerine http:// ile başladığı) için bu garantinin verilmeyeceğini unutmayın.

List komutu, en çok API istemcisinin iki öğenin birbiriyle nasıl ilişkili olduğunu bilmek veya belirli bir kaynak öğedeki tüm ilişkileri numaralandırmak istediği durumlarda kullanışlıdır. Örnek: kullanıcıların ilgili öğelere gitmesine yardımcı olan bir özellik. Bir mobil uygulama cihazda çalışırken bu özellik, ilgili web sitesine veya Google+ profiline gitmeyi kolaylaştırır.

AndroidAppAsset

Android uygulama öğesini tanımlar.

Alan adı Tür Açıklama
package_name string Android uygulama öğeleri doğal olarak Java paket adlarıyla tanımlanır. Örneğin, Google Haritalar uygulaması com.google.android.apps.maps paket adını kullanmaktadır. Zorunlu
certificate CertificateInfo

Paket adı benzersizliğine yönelik global bir yaptırım olmadığından, paket adıyla birlikte bir uygulamayı benzersiz şekilde tanımlayan bir imza sertifikası da gerekir.

Bazı uygulamaların imzalama anahtarları döndürüldüğünden zaman içinde farklı anahtarlarla imzalanabilir. Benzersiz kimlik olarak (paket adı, sertifika) kullandığımızdan bunları ayrı öğeler olarak değerlendiririz. Uygulamanın her iki sürümü de aynı veya benzer ifadeleri kullanacağından bu, normalde herhangi bir sorun teşkil etmez. Bununla birlikte, bir anahtar döndürüldüğünde uygulama hakkında açıklamalarda bulunan diğer öğelerin güncellenmesi gerekecektir.

(Belirtilen ifadeleri yayınlama ve sorgulamaya yönelik söz dizimlerinin, birden fazla sertifika tarafından bilinen uygulamaları kolayca belirtmenizi sağlamak için söz dizimsel şeker içerdiğini unutmayın.) Zorunlu

CertificateInfo

Bir X509 sertifikasını tanımlar.

Alan adı Tür Açıklama
sha256_fingerprint string

Sertifikanın büyük harfli SHA-265 parmak izi. PEM sertifikasından şu şekilde edinilebilir:

$ keytool -printcert -file $CERTFILE | grep SHA256:
SHA256: 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

veya aşağıdaki gibi:

$ openssl x509 -in $CERTFILE -noout -fingerprint -sha256
SHA256 Fingerprint=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

Bu örnekte, bu alanın içeriği 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 olur.

Bu araçları kullanamıyorsanız PEM sertifikasını DER biçimine dönüştürebilir, söz konusu dizenin SHA-256 karmasını hesaplayabilir ve sonucu onaltılık dize (yani her sekizliğin iki nokta üst üste ile ayrılmış büyük harfli onaltılık gösterimleri) olarak temsil edebilirsiniz.

Öğe

Bir öğeyi benzersiz olarak tanımlar.

Dijital varlık, genellikle belirli bir hizmet veya içerik sağlayan, tanımlanabilir ve adreslenebilir online tüzel kişilerdir. Öğelere örnek olarak web siteleri, Android uygulamaları, Twitter feed'leri ve Artı Sayfaları verilebilir.

Alan adı Tür Açıklama
Birlik alanı, aşağıdakilerden yalnızca biri:
web WebAsset Bunun bir web öğesi olup olmadığını ayarlayın.
android_app AndroidAppAsset Bunun bir Android uygulama öğesi olup olmadığını ayarlayın.

CheckRequest

Belirli bir öğe bağlantısının olup olmadığını kontrol etmek için kullanılan mesajdır.

Alan adı Tür Açıklama
source Asset İfade listesini barındıran kaynak. Bu, Check() çağrısını uygun kaynağa yönlendirmek için kullanılır.
relation string

İlişkiye ilişkin sorgu dizesi.

İlişkileri <kind>/<detail> biçimindeki dizelerle tanımlarız. Burada <kind> önceden tanımlanmış bir dizi amaç kategorisinden biri olmalıdır; <detail> ise ifadenin belirli kullanım alanını açıklayan serbest biçimli küçük harfli alfanümerik dizedir.

Desteklenen ilişkilerin güncel listesi için API belgelerimize bakın.

Sorgunun bir öğe bağlantısıyla eşleşmesi için hem sorgunun hem de öğe bağlantısının ilişki dizelerinin tam olarak eşleşmesi gerekir.

Örnek: delegate_permission/common.handle_all_urls ilişkisine sahip bir sorgu, delegate_permission/common.handle_all_urls ilişkisine sahip bir öğe bağlantısıyla eşleşiyor.
target Asset İfadenin hedef öğesi.

CheckResponse

CheckAssetLinks çağrısı için yanıt mesajı.

Alan adı Tür Açıklama
linked bool İstekte belirtilen öğeler istekte belirtilen ilişkiyle bağlanıyorsa "doğru" olarak ayarlanır. Zorunlu
max_age Duration Yayın tarihinden itibaren, başka güncellemeler engellenecekse yanıtın ne kadar süreyle geçerli olarak kabul edilmesi gerektiği. Zorunlu
debug_string string

Son kullanıcıların sonucu anlamasına, yeniden üretmesine ve hata ayıklamasına yardımcı olacak bilgiler içeren, kullanıcılar tarafından okunabilen mesaj.

Mesaj İngilizce olacaktır. Şu an için çeviri hizmeti sunmayı planlamıyoruz.

Bu dizenin içeriği veya biçimi hakkında herhangi bir garanti verilmediğini lütfen unutmayın. İşbu belgenin herhangi bir kısmı, bildirimde bulunulmaksızın değiştirilebilir. Bu verileri programlı bir şekilde ayrıştırmaya çalışmamalısınız. İhtiyacınız olan bilgiler API tarafından başka şekilde açığa çıkarılmadığı için bu işlemi yapmanız gerektiğini düşünüyorsanız lütfen önce bizimle iletişime geçin.

ListRequest

Belirli bir kaynağa ve ilişkisine sahip bilinen tüm ifadeleri istemek için kullanılan mesaj.

Alan adı Tür Açıklama
source Asset İfade listesini barındıran kaynak. Bu, List() isteğini doğru kaynağa yönlendirmek için kullanılır. Zorunlu
relation string

Yalnızca belirtilen ilişkiyle eşleşen ilişkilendirmeleri kullanın.

İlişki dizelerinin ayrıntılı tanımı için Statement mesajına bakın.

Sorgunun bir ifadeyle eşleşmesi için aşağıdakilerden biri doğru olmalıdır:

  • Hem sorgunun hem de ifadenin ilişki dizeleri tam olarak eşleşiyorsa veya
  • sorgunun ilişki dizesi boş veya eksik.

Örnek: delegate_permission/common.handle_all_urls ilişkisine sahip bir sorgu, delegate_permission/common.handle_all_urls ilişkisine sahip bir öğe bağlantısıyla eşleşiyor.

ListResponse

List çağrısı için yanıt mesajı.

Alan adı Tür Açıklama
statements Statement Bulunan tüm eşleşen ifadelerin listesi.
max_age Duration Yayın tarihinden itibaren, başka güncellemeler engellenecekse yanıtın ne kadar süreyle geçerli olarak kabul edilmesi gerektiği. Zorunlu
debug_string string

Son kullanıcıların sonucu anlamasına, yeniden üretmesine ve hata ayıklamasına yardımcı olacak bilgiler içeren, kullanıcılar tarafından okunabilen mesaj.

Mesaj İngilizce olacaktır. Şu an için çeviri hizmeti sunmayı planlamıyoruz.

Bu dizenin içeriği veya biçimi hakkında herhangi bir garanti verilmediğini lütfen unutmayın. İşbu belgenin herhangi bir kısmı, bildirimde bulunulmaksızın değiştirilebilir. Bu verileri programlı bir şekilde ayrıştırmaya çalışmamalısınız. İhtiyacınız olan bilgiler API tarafından başka şekilde açığa çıkarılmadığı için bu işlemi yapmanız gerektiğini düşünüyorsanız lütfen önce bizimle iletişime geçin.

İfade

Kaynak öğe ile hedef öğe arasındaki ilişki hakkında yapılan güvenilir bir açıklamayı ifade eder.

İfadeler her zaman kaynak öğe tarafından, doğrudan veya başka bir yerde depolanan bir ifade listesine yetki vererek yapılır.

İfadelerin ve öğelerin daha ayrıntılı tanımları için lütfen API belgeleri açılış sayfamıza bakın.

Alan adı Tür Açıklama
source Asset Her ifadenin bir kaynak öğesi vardır. Zorunlu
relation string

İlişki, kaynak öğenin sahibi (yani, ifadeyi yayınlayan kişi veya tüzel kişi) tarafından amaçlandığı şekilde ifadenin kullanımını tanımlar. Her ifadenin bir ilişkisi vardır.

İlişkileri <kind>/<detail> biçimindeki dizelerle tanımlarız. Burada <kind> önceden tanımlanmış bir dizi amaç kategorisinden biri olmalıdır; <detail> ise ifadenin belirli kullanım alanını açıklayan serbest biçimli küçük harfli alfanümerik dizedir.

Desteklenen ilişkilerin güncel listesi için API belgelerimize bakın.

Örnek: delegate_permission/common.handle_all_urls REQUIRED
target Asset Her ifadenin bir hedef öğesi vardır. Zorunlu

WebAsset

Bir web öğesini tanımlar.

Alan adı Tür Açıklama
site string

Web öğeleri yalnızca şema, ana makine adı ve bağlantı noktası bölümlerini içeren bir URL ile tanımlanır. Biçim

http[s]://<hostname>[:<port>]

Ana makine adları tam olmalıdır: Tek bir nokta (".") ile sona ermelidir.

Şu anda yalnızca "http" ve "https" şemalarına izin verilmektedir.

Bağlantı noktası numaraları ondalık sayı olarak verilir ve standart bağlantı noktası numaraları kullanılıyorsa bunlar atlanmalıdır: http için 80 ve https için 443.

Bu sınırlı URL'ye "site" diyoruz. Aynı şemayı, ana makine adını ve bağlantı noktasını paylaşan tüm URL'ler, sitenin bir parçası ve dolayısıyla web öğesine ait kabul edilir.

Örnek: https://www.google.com sitesini içeren öğe şu URL'lerin tümünü içeriyor:

  • https://www.google.com/
  • https://www.google.com:443/
  • https://www.google.com/foo
  • https://www.google.com/foo?bar
  • https://www.google.com/foo#bar
  • https://user@password:www.google.com/

Ancak, aşağıdaki URL'leri içermez:

  • http://www.google.com/ (yanlış şema)
  • https://google.com/ (ana makine adı eşleşmiyor)
  • https://www.google.com:444/ (bağlantı noktası eşleşmiyor) GEREKLİ