Method: subscriptions.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: subscriptions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Subscriptions.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists of subscriptions managed by the reseller. The list can be all subscriptions, all of a customer's subscriptions, or all of a customer's transferable subscriptions.\n\nOptionally, this method can filter the response by a `customerNamePrefix`. For more information, see [manage subscriptions](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_subscriptions).\n\n### HTTP request\n\n`GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n| `customerId` | `string` This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable. |\n| `customerNamePrefix` | `string` When retrieving all of your subscriptions and filtering for specific customers, you can enter a prefix for a customer name. Using an example customer group that includes `exam.com`, `example20.com` and `example.com`: - `exa` -- Returns all customer names that start with 'exa' which could include `exam.com`, `example20.com`, and `example.com`. A name prefix is similar to using a regular expression's asterisk, exa\\*. - `example` -- Returns `example20.com` and `example.com`. \u003cbr /\u003e |\n| `maxResults` | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` When retrieving a large list, the `maxResults` is the maximum number of results per page. The `nextPageToken` value takes you to the next page. The default is 20. |\n| `pageToken` | `string` Token to specify next page in the list |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA subscription manages the relationship of a Google customer's payment plan with a product's SKU, user licenses, 30-day free trial status, and renewal options. A primary role of a reseller is to manage the Google customer's subscriptions.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"subscriptions\": [ { object (/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the resource as a collection of subscriptions. Value: reseller#subscriptions |\n| `subscriptions[]` | `object (`[Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription)`)` The subscriptions in this page of results. |\n| `nextPageToken` | `string` The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/apps.order`\n- `\n https://www.googleapis.com/auth/apps.order.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
