Method statements.list

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.

HTTP isteği

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

Sorgu parametreleri

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

İstek metni

İ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:

Liste çağrısının 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ınlanma zamanından itibaren diğer güncellemelerin engellenmesi için ne kadar süre geçerli olarak kabul edilmesi gerekir? ZORUNLU

Saniyede en fazla dokuz ondalık basamak içeren ve "s" ile sonlanan süre. Örnek: "3.5s"
debugString 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.

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, 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 object(Asset) Her ifadenin bir hedef öğesi vardır. ZORUNLU

Deneyin.

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