Method statements.list

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.

HTTP isteği

GET https://digitalassetlinks.googleapis.com/v1/statements:list

Sorgu parametreleri

Parametre adı Tür Açıklama
source object(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.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

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

JSON gösterimi 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Alan adı Tür Açıklama
statements[] object(Statement) Bulunan tüm eşleşen ifadelerin listesi.
maxAge string

Yayın tarihinden itibaren, başka güncellemeler engellenecekse yanıtın ne kadar süreyle geçerli olarak kabul edilmesi gerektiği. Zorunlu

En fazla dokuz kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden süre. Örnek: "3.5s".
debugString 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.

JSON gösterimi 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Alan adı Tür Açıklama
source object(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 object(Asset) Her ifadenin bir hedef öğesi vardır. Zorunlu

Deneyin.

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için API Gezgini'ni kullanın.