Method: subscriptions.list

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

İsteğe bağlı olarak bu yöntem, yanıtı customerNamePrefix değerine göre filtreleyebilir. Daha fazla bilgi için Abonelikleri yönetme başlıklı makaleyi inceleyin.

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 aktaran 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ık bir kimlik doğrulama jetonudur. Daha fazla bilgi için yönetici yardım merkezine göz atın.
customerId

string

Bu, müşterinin birincil alan adı veya benzersiz tanımlayıcısıdır. 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üğü şekilde) her zaman kullanılabilir. Uygun olduğu durumlarda benzersiz tanımlayıcıyı sistemlerinizde saklamanızı öneririz.
customerNamePrefix

string

Tüm aboneliklerinizi alırken ve belirli müşteriler için filtreleme yaparken müşteri adı için bir ön ek girebilirsiniz. exam.com, example20.com ve example.com'yi içeren örnek bir müşteri grubunu kullanarak:

  • exa: "exa" ile başlayan tüm müşteri adlarını döndürür. Bu adlar exam.com, example20.com ve example.com içerebilir. Ad ön eki, normal ifadenin yıldız işaretini (exa*) kullanmaya benzer.
  • example: example20.com ve example.com döndürür.
maxResults

integer (uint32 format)

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

string

Listede sonraki sayfayı belirtmek için jeton

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Abonelik, Google müşterisinin ödeme planının bir ürünün SKU'suyla, kullanıcı lisanslarıyla, 30 günlük ücretsiz deneme durumuyla ve yenileme seçenekleriyle ilişkisini 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ğı abonelik koleksiyonu olarak tanımlar. Değer: bayi#abonelikler
subscriptions[]

object (Subscription)

Bu sonuç sayfasındaki abonelikler.
nextPageToken

string

Büyük sonuç kümelerinde sayfalama yapmak için kullanılan devam jetonu. Sonuçların bir sonraki sayfasını döndürmek için sonraki bir isteğinde 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ılavuzuna bakın.