Package google.digitalassetlinks.v1

Dizin

Durumlar

Bu API hizmeti, öğe sahipleri tarafından öğe bağlantıları hakkında bilgi yayınlamak için kullanılan araçlar olan "ifadeler" sunar. API, ifadeleri doğrudan kaynaklardan edinmenize 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 öğelerle ilgili dijital öğeler (ör. web siteleri veya Android uygulamaları) adına yapılmıştır. Her ifade bir kaynak öğe, bir hedef öğe ve bir veya daha fazla ilişki içerir.

İlişki, kaynak öğe tarafından hak talebinde bulunulan iki öğe arasındaki ilişkiyi açıklar. Bu tür ilişkilerin bir örneği, ayrıcalıkların veya izinlerin yetkisidir.

Liste

rpc List(ListRequest) returns (ListResponse)

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

Dijital Öğe Bağlantıları teknik tasarım spesifikasyonunda açıklandığı gibi, API, HTTPS web siteleri veya Android uygulamaları gibi güvenli kaynak öğeleri içeren tüm ifadelerin, bu öğelerin sahibi tarafından güvenli bir şekilde yapılacağını garanti eder. Daha ayrıntılı olarak belirtmek gerekirse, güvenli olmayan web sitelerinde (yani URL, https:// yerine http:// ile başlar) bu garantinin verilemediğini unutmayın.

List komutu en çok, API istemcisinin iki öğenin ilişkili olduğu tüm yolları bilmesini veya belirli bir kaynak öğedeki tüm ilişkileri numaralandırmasını istediği durumlarda yararlıdır. Örnek: Kullanıcıların ilgili öğelere gitmesine yardımcı olan bir özellik. Bu özellik bir mobil uygulama bir cihazda çalışırken ilgili web sitesine veya Google+ profiline gitmenizi kolaylaştırır.

AndroidUygulamaÖğesi

Bir Android uygulama öğesini açıklar.

Alan adı Tür Açıklama
package_name string Android App öğeleri doğal olarak Java paket adlarına göre tanımlanır. Örneğin, Google Haritalar uygulaması com.google.android.apps.maps paket adını kullanır. ZORUNLU
certificate CertificateInfo

Paket adının benzersiz olması için global bir yaptırım olmadığından, paket adıyla birlikte bir uygulamayı benzersiz şekilde tanımlayan bir imzalama sertifikasına da ihtiyaç duyarız.

Bazı uygulamaların imzalama anahtarları döndürülür. Bu nedenle, zaman içinde farklı anahtarlarla imzalanabilirler. Benzersiz kimlik olarak (paket adı, sertifika) kullandığımız için bunları ayrı öğeler olarak değerlendiririz. Uygulamanın her iki sürümü de aynı veya benzer ifadeleri kullanacağından, bu durum normal olarak bir sorun yaratmamalıdır. Bununla birlikte, anahtar döndürüldüğünde uygulama hakkında beyanlarda bulunan diğer öğelerin güncellenmesi gerekir.

(Birden çok sertifikayla bilinen uygulamaları kolayca belirtmenize olanak tanıyan, ifadeleri beyan etme ve sorgulama söz diziminin söz dizimsel şeker içerdiğini unutmayın.) ZORUNLU

Sertifika Bilgisi

Bir X509 sertifikasını açıklar.

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

Sertifikanın büyük 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 şunun 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 olacaktır.

Bu araçlar sizin için uygun değilse PEM sertifikasını DER biçimine dönüştürebilir, bu dizenin SHA-256 karmasını hesaplayabilir ve sonucu onaltılık dize olarak (yani, her bir sekizliğin büyük harf onaltılı, iki noktayla ayrılmış şekilde) temsil edebilirsiniz.

Öğe

Bir öğeyi benzersiz şekilde tanımlar.

Dijital öğeler, genellikle bazı hizmetler veya içerikler sunan tanımlanabilir ve ele alınabilir bir online varlıktır. Web sitelerine, Android uygulamalarına, Twitter feed'lerine ve Plus Pages, öğelere örnek olarak gösterilebilir.

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

Kontrol İsteği

Belirli bir öğe bağlantısının varlığını kontrol etmek için kullanılan mesaj.

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

İlişki için sorgu dizesi.

<kind>/<detail> biçiminin dizeleriyle olan ilişkileri belirleriz. Burada, <kind> önceden tanımlanmış bir dizi hedef kategoriden biri ve <detail> ifadenin belirli bir kullanım alanını açıklayan serbest biçimli küçük alfanümerik bir dizedir.

Desteklenen ilişkilerin mevcut listesi için API dokümanlarımıza göz atın.

Bir 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.

Yanıt Yanıtı

CheckAssetLinks çağrısının yanıt mesajı.

Alan adı Tür Açıklama
linked bool İstekte belirtilen öğeler, istekte belirtilen ilişki tarafından bağlıysa "true" olarak ayarlanır. ZORUNLU
max_age Duration Yayınlanma zamanından itibaren diğer güncellemelerin engellenmesi için ne kadar süre geçerli olarak kabul edilmesi gerekir? ZORUNLU
debug_string string

Son kullanıcıların sonucu anlamasına, yeniden oluşturmasına ve hata ayıklamasına yardımcı olmayı amaçlayan bilgiler içeren, kullanıcılar tarafından okunabilir ileti.

Mesaj İngilizce olacaktır ve şu anda çeviri sunmayı düşünmüyoruz.

Bu dizenin içeriği veya biçimiyle ilgili herhangi bir garanti verilmediğini lütfen unutmayın. Herhangi bir boyutu önceden haber verilmeden değiştirilebilir. Bu verileri programatik olarak ayrıştırmaya çalışmamalısınız. İhtiyaç duyduğunuz bilgiler başka nedenlerle API'de açığa çıkmadığı için bunu yapmanız gerektiğini düşünüyorsanız lütfen önce bizimle iletişime geçin.

Liste İsteği

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

Alan adı Tür Açıklama
source Asset Ekstre listesini barındıran kaynak. 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.

Bir 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.

Liste yanıtı

Liste çağrısının yanıt mesajı.

Alan adı Tür Açıklama
statements Statement Bulunan tüm eşleşen ifadelerin listesi.
max_age Duration Yayınlanma zamanından itibaren diğer güncellemelerin engellenmesi için ne kadar süre geçerli olarak kabul edilmesi gerekir? ZORUNLU
debug_string string

Son kullanıcıların sonucu anlamasına, yeniden oluşturmasına ve hata ayıklamasına yardımcı olmayı amaçlayan bilgiler içeren, kullanıcılar tarafından okunabilir ileti.

Mesaj İngilizce olacaktır ve şu anda çeviri sunmayı düşünmüyoruz.

Bu dizenin içeriği veya biçimiyle ilgili herhangi bir garanti verilmediğini lütfen unutmayın. Herhangi bir boyutu önceden haber verilmeden değiştirilebilir. Bu verileri programatik olarak ayrıştırmaya çalışmamalısınız. İhtiyaç duyduğunuz bilgiler başka nedenlerle API'de açığa çıkmadığı için bunu 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ılmış güvenilir bir açıklamayı açıklar.

Açıklamalar her zaman kaynak öğeyle doğrudan veya başka bir yerde depolanan bir ifade listesine yetki verilir.

Açıklamalar ve öğelerin daha ayrıntılı tanımları için lütfen API dokümanları 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, ifadenin kaynak öğenin sahibi (yani beyanı veren kişi veya tüzel kişi) amaçlandığı şekilde kullanımını tanımlar. Her tam ifadenin bir ilişkisi vardır.

<kind>/<detail> biçiminin dizeleriyle olan ilişkileri belirleriz. Burada, <kind> önceden tanımlanmış bir dizi hedef kategoriden biri ve <detail> ifadenin belirli bir kullanım alanını açıklayan serbest biçimli küçük alfanümerik bir dizedir.

Desteklenen ilişkilerin mevcut listesi için API dokümanlarımıza göz atın.

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

WebÖğesi

Bir web öğesini açıklar.

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çimi

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

Ana makine adlarının tam olması gerekir: Tek bir noktayla bitmelidir (".").

Ş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ı olarak kabul edilir. Bu nedenle, web öğesine aittir.

Örnek: https://www.google.com sitesine sahip öğ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 şu 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İ