Nachdem Sie ein Kundenkonto bestellt haben, können Sie eine Reihe verschiedener Abos erstellen:
- Ein Abo mit jährlicher Zusicherung
- Ein flexibles Abo
- 30-tägige Testversion
- Abo mit Rabatt
Weitere Informationen zu den Produkten, die für diese Abos verwendet werden, finden Sie unter Produkte und SKUs.
Wenn Sie das Konto dieses Kunden nicht bestellt haben, können Sie ein Abo übertragen.
Kunden mit customerType = 'team' können nur die Essentials- und Enterprise Essentials-Versionen von Google Workspace erwerben. Wenn Sie versuchen, eines der anderen Google Workspace-Abos zu erwerben, erhalten Sie die Fehlermeldung Customer is not eligible to purchase this subscription. Kunden, die Essentials- oder nutzungsbasierte Abos erwerben, können möglicherweise keine Jahresverpflichtungspläne nutzen und haben nur eingeschränkte Upgrade- und Downgrade-Optionen.
Abo erstellen
Wenn Sie ein Abo für das Konto eines neu erstellten Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
CUSTOMER_ID ist entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden, die beim Abrufen des Kontos eines weiterverkauften Kunden zurückgegeben wird.
Jahreszusicherungstarif erstellen
Bei Abos mit jährlicher Zusicherung haben nicht alle Artikelnummern dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, immer renewalSettings zu übergeben. Erstellen Sie ein Jahresabo mit Zusicherung und 10 Arbeitsplätzen:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID: Die eindeutige Artikelnummer-ID. Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Eine erfolgreiche Antwort gibt den HTTP-Status 200 und die Einstellungen des neuen Abos für einen Jahresvertrag zurück. ANNUAL_MONTHLY_PAY wird in allen API-Antworten als ANNUAL zurückgegeben.
Hier ist ein Beispiel für eine Antwort auf eine Anfrage zu einem Jahresabo:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Flexiblen Plan erstellen
Wenn Sie ein flexibles Abo für das Konto eines neu erstellten Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "FLEXIBLE"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID: Die eindeutige Artikelnummer-ID. Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Hier ist ein Beispiel für eine Antwort auf einen flexiblen Plan:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Kostenlosen Testzeitraum erstellen
Wenn Sie ein 30‑tägiges Probeabo für das Konto eines neu erstellten Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "TRIAL"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID: Die eindeutige Artikelnummer-ID. Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Hier ist ein Beispiel für eine Antwort auf ein 30‑tägiges Probeabo:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Abo mit Rabatt erstellen
Google stellt möglicherweise einen Angebotscode zur Verfügung, mit dem du Abos zu einem ermäßigten Preis erstellen kannst. Wenn Sie ein Abo rabattieren möchten, müssen Sie den Deal-Code im insert-Aufruf für das Abo angeben. Wenn der Kunde die ursprüngliche SKU ändert, wird der Rabatt entfernt.
Wenn Sie ein Jahresabo mit Rabatt für das Konto eines neu erstellten Kunden erstellen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID: Die eindeutige Artikelnummer-ID. Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.GOOGLE_CONTRACT_DEAL_CODE: Ein von Google bereitgestellter Rabattcode.
Hier ist ein Beispiel für eine Antwort auf ein Jahresabo mit Rabatt:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
Abo übertragen
Wenn Sie das Konto des Kunden nicht mit dem Vorgang Neues Kundenkonto bestellen bestellt haben, verwenden Sie das Übertragungstoken des Kunden, wenn Sie ein Abo für diesen Kunden erstellen.
Wenn Sie ein Abo für ein Kundenkonto erstellen möchten, das Sie nicht bestellt haben, verwenden Sie die folgende POST-HTTP-Anfrage:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.TOKEN_VALUE: Ein von Ihrem Kunden bereitgestelltes Übertragungstoken. Nachdem der Kunde das Token generiert hat, ist es 30 Tage lang gültig.
Weitere Informationen dazu, wie Kunden ein Übertragungstoken erhalten, finden Sie in der Google Workspace-Hilfe.
Wenn Sie das Abo eines Kunden mit Jahresvertrag übertragen möchten, verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Ersetzen Sie Folgendes:
CUSTOMER_ID: Entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden.SKU_ID: Die eindeutige Artikelnummer-ID. Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestell-ID, mit der Sie die Nutzung nachverfolgen können.
Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Einstellungen des übertragenen Abos für einen Jahresvertrag zurückgegeben:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
Einschränkungen bei der Übertragung
Wenn Sie ein Google Workspace-Abo mit einem zugehörigen Google Drive- oder Google Vault-Abo übertragen, verwenden Sie den batch-Vorgang, um alle Abos mit dem Status ACTIVE zu übertragen. Die Übertragung jedes Abos einzeln führt zu einem Fehler.
Die Übertragung gesperrter Abos ist nur zulässig, wenn der Grund für die Sperrung PENDING_TOS_ACCEPTANCE, TRIAL_ENDED oder RENEWAL_WITH_TYPE_CANCEL ist.
Beim Übertragen einer alten Artikelnummer gibt subscriptions.list eine skuId der zu übertragenden Artikelnummer zurück. Die skuIdder SKU, die der Kunde tatsächlich hat, wird als transferInfo.currentLegacySkuId zurückgegeben. Eine vollständige Liste der skuIds und der Produkte, die in diesen Abos verwendet werden, finden Sie unter Produkte und SKUs.
Übertragungen funktionieren nicht mit Rabattcodes.