Method: subscriptions.list

Bayi tarafından yönetilen aboneliklerin listeleri. Bu liste tüm abonelikler, müşterinin tüm abonelikleri veya müşterinin aktarılabilir aboneliklerinin tümü olabilir.

İsteğe bağlı olarak, bu yöntem yanıtı bir customerNamePrefix değerine göre 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 müşterinin aboneliğini veya başka bir bayi müşterisinin aboneliğini bayi yönetiminize aktaran bir yeniden satış hesabı oluştururken customerAuthToken sorgu dizesi gereklidir. 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ülen) her zaman kullanılabilir. Uygun olduğu durumlarda, benzersiz tanımlayıcıyı sistemlerinizde depolamanızı öneririz.
customerNamePrefix

string

Tüm aboneliklerinizi alırken ve belirli müşterileri filtrelerken müşteri adı için bir önek girebilirsiniz. exam.com, example20.com ve example.com içeren bir müşteri grubu örneği kullanarak:

  • exa -- exam.com, example20.com ve example.com içerebilecek "exa" ile başlayan tüm müşteri adlarını döndürür. Ad öneki, normal ifadenin yıldız işareti, exa* kullanımına benzer.
  • example -- example20.com ve example.com döndürür.
maxResults

integer (uint32 format)

Büyük bir liste alı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

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

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Abonelik; bir Google müşterisinin ödeme planı ile ürünün SKU'su, kullanıcı lisansları, 30 günlük ücretsiz deneme durumu ve yenileme seçenekleriyle olan ilişkiyi yönetir. Bayilerin birincil rolü, 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ğı aboneliklerden oluşan bir koleksiyon olarak tanımlar. Değer: bayi#subscriptions
subscriptions[]

object (Subscription)

Bu sonuç sayfasındaki abonelikler.
nextPageToken

string

Büyük sonuç grupları arasında sayfa görüntülemek için kullanılan devam jetonu. Sonraki sonuç sayfasını döndürmek için bu değeri sonraki bir istekte 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ılavuzuna göz atın.