Method: subscriptions.list

Bayi tarafından yönetilen aboneliklerin listeleri. Liste; tüm abonelikler, müşteri abonelikleri veya müşterinin aktarılabilir aboneliklerinin tamamı olabilir.

İsteğe bağlı olarak, bu yöntem yanıtı bir customerNamePrefix ile filtreleyebilir. Daha fazla bilgi için abonelikleri yönetme başlıklı makaleye bakın.

HTTP isteği

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
customerAuthToken

string

Doğrudan bir müşterinin aboneliğini veya başka bir bayi müşterinin aboneliğini bayi yönetiminize aktaran bir yeniden satış yapılan hesap oluştururken customerAuthToken sorgu dizesi gerekir. Bu, abonelik aktarımını tamamlamak için gereken on altılı kimlik doğrulama jetonudur. Daha fazla bilgi edinmek için yönetici yardım merkezine göz atın.
customerId

string

Bu, müşterinin birincil alan adı veya müşterinin benzersiz tanımlayıcısı olabilir. Bir müşterinin alan adı değişirse müşteriye erişmek için eski alan adı kullanılamaz ancak müşterinin benzersiz tanımlayıcısı (API tarafından döndürüldüğü şekliyle) her zaman kullanılabilir. Benzersiz tanımlayıcıyı, uygun olduğu durumlarda sistemlerinizde depolamanızı öneririz.
customerNamePrefix

string

Tüm aboneliklerinizi alırken ve belirli müşterilere göre filtre uygularken müşteri adı için bir önek girebilirsiniz. exam.com, example20.com ve example.com içeren örnek bir müşteri grubu kullanarak:

  • exa -- "exa" ile başlayan tüm müşteri adlarını döndürür exam.com, example20.com ve example.com dahil olabilir. Ad öneki, normal ifadede yıldız işareti (exa*) kullanmaya benzer.
  • example -- example20.com ve example.com değerini döndürür.
maxResults

integer (uint32 format)

Büyük bir liste alınırken maxResults, sayfa başına maksimum sonuç sayısıdır. nextPageToken değeri sizi sonraki sayfaya götürür. Varsayılan değer 20'dir.
pageToken

string

Listede sonraki sayfayı belirtmek için kullanılan jeton

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Abonelik; Google müşterisinin ödeme planı ile ürünün SKU'su, kullanıcı lisansları, 30 günlük ücretsiz deneme durumu ve yenileme seçenekleri arasındaki ilişkiyi yönetir. Bayilerin birincil rollerinden biri, Google müşterisinin aboneliklerini yönetmektir.

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

JSON gösterimi 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

Kaynağı bir abonelik koleksiyonu olarak tanımlar. Değer: bayi#subscriptions
subscriptions[]

object (Subscription)

Bu sonuç sayfasındaki abonelikler.
nextPageToken

string

Büyük sonuç kümelerinde gezinmek için kullanılan devam jetonu. Sonuçların sonraki sayfasını döndürmek için sonraki bir istekte bu değeri sağlayın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.