Nachdem Sie das Konto eines Kunden bestellt haben, können Sie eine Reihe verschiedener Abos erstellen:
- Ein Abo mit jährlicher Zusicherung
- Ein flexibles Abo
- Eine 30-tägige kostenlose Testversion
- Ein Abo mit Rabatt
Weitere Informationen zu den Produkten, die mit diesen Abos verwendet werden, finden Sie unter Produkte und Artikelnummern.
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 eingeschränkte 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 Tarif mit jährlicher Zusicherung haben nicht alle Artikelnummern dieselben Standardeinstellungen für die Verlängerung. Wir empfehlen, immer renewalSettings zu übergeben. So erstellen Sie ein Abo mit jährlicher Zusicherung mit 10 Lizenzen:
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 Artikelnummern.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 auf 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 Artikelnummern.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Hier ist ein Beispiel für eine Antwort auf 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"
}
Kostenlose Testversion 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 Artikelnummern.PURCHASE_ORDER_ID: Eine optionale Bestellnummer, mit der Sie die Nutzung verfolgen können.
Hier ist ein Beispiel für eine Antwort auf 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 kann einen Angebotscode bereitstellen, 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 die ursprüngliche Artikelnummer ä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 Artikelnummern.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 auf 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 Neues Kundenkonto bestellen 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 bereitgestellt 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 Artikelnummern.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 Artikelnummer gibt subscriptions.list eine skuId der Artikelnummer zurück, die übertragen werden muss. Die skuId der Artikelnummer, die der Kunde tatsächlich hat, wird als transferInfo.currentLegacySkuId zurückgegeben. Eine vollständige Liste der skuIds und der Produkte, die mit diesen Tarifen verwendet werden, finden Sie unter
Produkte und Artikelnummern.
Übertragungen funktionieren nicht mit Rabattcodes.