Nachdem Sie das Konto eines Kunden bestellt haben, können Sie eine Reihe verschiedener Abos erstellen:
- Abo mit jährlicher Zusicherung
- Flexibles Abo
- 30-tägiger kostenloser Testzeitraum
- Abo mit Rabatt
Weitere Informationen zu den Produkten, die in diesen Abos verwendet werden, finden Sie unter Produkte und SKUs.
Wenn Sie das Konto des Kunden nicht bestellt haben, können Sie ein Abo übertragen.
Kunden mit customerType = 'team' können nur die Google Workspace-Versionen Google Workspace Essentials
und Google Workspace Enterprise Essentials erwerben. Wenn Sie versuchen, andere Google Workspace-Abos zu erwerben, wird der Fehler Customer is not eligible to purchase this subscription angezeigt.
Kunden, die Essentials- oder nutzungsbasierte Abos erwerben, können möglicherweise keine Tarife mit jährlicher Zusicherung nutzen und haben nur begrenzte Upgrade- und Downgrade-Optionen.
Abo erstellen
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um ein Abo für das Konto eines neuen Kunden zu erstellen:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Der 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.
Tarif mit jährlicher Zusicherung erstellen
Bei Abos mit jährlicher Zusicherung haben nicht alle SKUs dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, immer renewalSettings zu übergeben. So erstellen Sie ein Abo mit jährlicher Zusicherung mit 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 (SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Bei einer erfolgreichen Antwort wird der HTTP-Status 200 und die Einstellungen des neuen Abos für einen Tarif mit jährlicher Zusicherung zurückgegeben. ANNUAL_MONTHLY_PAY
wird in allen API-Antworten als ANNUAL zurückgegeben.
Hier ist ein Beispiel für eine Antwort für einen Jahrestarif:
{
"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 Tarif erstellen
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um ein flexibles Abo für das Konto eines neuen Kunden zu erstellen:
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 (SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Hier ist ein Beispiel für eine Antwort für einen flexiblen Tarif:
{
"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
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um ein 30-tägiges kostenloses Testabo für das Konto eines neuen Kunden zu erstellen:
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 (SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Hier ist ein Beispiel für eine Antwort für einen 30-tägigen kostenlosen Testzeitraum:
{
"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 Sie Abos zu einem ermäßigten Preis erstellen können. Wenn Sie einen Rabatt auf ein Abo erhalten möchten, müssen Sie den Angebotscode im insert-Aufruf des Abos angeben. Wenn der Kunde seine ursprüngliche SKU ändert, wird der Rabatt entfernt.
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um ein Abo mit jährlicher Zusicherung mit Rabatt für das Konto eines neuen Kunden zu erstellen:
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 (SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.GOOGLE_CONTRACT_DEAL_CODE: Ein Rabattcode, der von Google zur Verfügung gestellt wird.
Hier ist ein Beispiel für eine Antwort für einen Jahrestarif 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 zum Bestellen eines neuen Kundenkontos bestellt haben, verwenden Sie das Übertragungstoken des Kunden, wenn Sie ein Abo für diesen Kunden erstellen.
Verwenden Sie die folgende POST-HTTP-Anfrage, um ein Abo für ein Kundenkonto zu erstellen, das Sie nicht bestellt haben:
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 Übertragungstoken, das von Ihrem Kunden zur Verfügung gestellt wird. 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 Admin-Hilfe.
Verwenden Sie die folgende POST-HTTP-Anfrage und fügen Sie das Autorisierungstoken ein, um das Abo eines Kunden mit einem Tarif mit jährlicher Zusicherung zu übertragen:
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 (SKU). Weitere Informationen finden Sie unter Produkte und SKU-IDs.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und die Einstellungen des übertragenen Abos für einen Tarif mit jährlicher Zusicherung 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. Wenn Sie jedes Abo einzeln übertragen, tritt ein Fehler auf.
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 älteren SKU gibt subscriptions.list eine skuId der SKU zurück, die übertragen werden muss. Die skuId der 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 Tarifen verwendet werden, finden Sie unter
Produkte und SKUs.
Übertragungen funktionieren nicht mit Rabattcodes.