Method: subscriptions.insert
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Abonelik oluşturur veya aktarır.
Yeni müşteri hesabı sipariş etme yöntemini kullanarak sipariş ettiğiniz müşterinin hesabı için bir abonelik oluşturun. Farklı ödeme planları için abonelik oluşturma hakkında daha fazla bilgi için Abonelikleri yönetme başlıklı makaleyi inceleyin.\
Müşterinin hesabını müşteri ekleme yöntemini kullanarak sipariş etmediyseniz söz konusu müşteri için abonelik oluştururken müşterinin customerAuthToken değerini kullanın.
Bir G Suite aboneliğini ilişkili Google Drive veya Google Apps Kasası aboneliğiyle birlikte aktarıyorsanız bu aboneliklerin tümünü aktarmak için toplu işlemi kullanın. Daha fazla bilgi için abonelik aktarma konusuna bakın.
HTTP isteği
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
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.
|
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.
|
İstek içeriği
İstek metni, Subscription öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir Subscription örneği içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/apps.order
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.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates or transfer a subscription.\n\nCreate a subscription for a customer's account that you ordered using the [Order a new customer account](/workspace/admin/reseller/v1/reference/customers/insert) method. For more information about creating a subscription for different payment plans, see [manage subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#create_subscription).\\\\\n\nIf you did not order the customer's account using the customer insert method, use the customer's `customerAuthToken` when creating a subscription for that customer.\n\nIf transferring a G Suite subscription with an associated Google Drive or Google Vault subscription, use the [batch operation](/workspace/admin/reseller/v1/how-tos/batch) to transfer all of these subscriptions. For more information, see how to [transfer subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\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\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\n### Request body\n\nThe request body contains an instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
