Bevor Sie ein neues Kundenkonto erstellen, sollten Sie Folgendes berücksichtigen:
- Möglicherweise gelten Einschränkungen für die Ländervorwahl. In der Partner Sales Console können Sie prüfen, ob das Land des Kunden für den Weiterverkauf genehmigt ist.
- Wenn das Konto durch ein Upgrade von einem privaten Gmail-Konto auf eine geschäftliche E-Mail-Adresse mit Domainnamen erstellt wird, müssen zusätzliche Google Workspace-Einstellungen entsperrt sein. Weitere Informationen finden Sie unter Geschäftliche E-Mail-Adressen für Ihr Team erstellen und Geschäftlichen E-Mail-Alias erstellen.
Kundenkonto erstellen
Verwenden Sie die folgende
POST
-Anfrage und fügen Sie das Autorisierungstoken ein, um ein Kundenkonto zu erstellen:POST https://reseller.googleapis.com/apps/reseller/v1/customers
Erstellen Sie einen Nutzer im Konto des neuen Kunden. Wenn die Antwort den HTTP-Statuscode
409 Conflict
zurückgibt, istcustomerId
bereits vorhanden. Bevor Sie das Kundenkonto registrieren, müssen Sie die Abos des Kunden übertragen.Nutzer auf Super Admin-Rolle hochstufen Beim Erstellen des Administratorkontos können Sie entweder ein temporäres zufälliges Passwort generieren oder den Kunden zur Eingabe eines Passworts auffordern.
Teilen Sie dem Kunden mit, dass er sich in der Admin-Konsole anmelden und die Vereinbarung für Google Workspace über Reseller unterzeichnen muss, um sein Konto zu aktivieren. Resellern ist es untersagt, die Nutzungsbedingungen im Namen des Kunden zu unterzeichnen.
Kundentypen
Sie können in Google Workspace zwei Arten von Kunden erstellen:
- Kunden mit Domainbestätigung: Diese Kunden benötigen Gmail
und vollständigen Administratorzugriff. Wenn Sie diesen Kundentyp erstellen, legen Sie
customerType
aufdomain
fest. - Kunden mit bestätigter E-Mail-Adresse: Diese Kunden sind nicht Inhaber und Administrator ihrer Domain. Wenn Sie diesen Kundentyp erstellen, legen Sie
customerType
aufteam
fest. Diese Kundentypen können Essentials und Enterprise Essentials von Google Workspace erwerben.
Der folgende JSON-Anfragetext ist ein Beispiel für einen Kunden mit Domainbestätigung:
{ "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
Ersetzen Sie Folgendes:
DOMAIN_NAME
: die Domain Ihres Kunden, z. B.example.com
NAME
: der Name Ihres Kunden, z. B.Alex Cruz
ORGANIZATION_NAME
: der Organisationsname Ihres Kunden, z. B.Example Organization
.POSTAL_CODE
: die Postleitzahl des Kunden, z. B.94043
COUNTRY_CODE
: Der zweistellige ISO-Ländercode Ihres Kunden.EMAIL_ADDRESS
: die E-Mail-Adresse Ihres Kunden, z. B.cruz@example.com
Bei einer erfolgreichen Antwort werden der HTTP-Statuscode 200
und die Informationen des Neukunden zurückgegeben:
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
Der folgende JSON-Anfragetext ist ein Beispiel für einen Kunden mit E-Mail-Bestätigung:
{ "customerDomain": "DOMAIN_NAME", "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
Bei einer erfolgreichen Antwort werden der HTTP-Statuscode 200
und die Informationen des Neukunden zurückgegeben:
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME, "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
Standardsprache eines Kunden ändern
Die Standardsprache eines Kunden wird nur auf neue Nutzer angewendet, wenn diese erstellt werden. Bestehende Nutzer behalten ihre aktuelle Sprache, auch nachdem Sie die Standardsprache aktualisiert haben. Daher müssen Sie die Standardsprache des Kunden festlegen, bevor Sie Nutzer erstellen.
Für einen neu erstellten Kunden ist Englisch als Standardsprache eingestellt. Verwenden Sie zum Ändern der Standardsprache die PATCH
- oder UPDATE
-Aufrufe des Customers-Endpunkts der Directory API.
Verwenden Sie die Directory API, um den Standardwert language
für einen Kunden zu aktualisieren:
PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID
Fügen Sie den folgenden JSON-Anfragetext ein:
{ "language":"LANGUAGE_CODE" }
Ersetzen Sie Folgendes:
CUSTOMER_ID
: eine eindeutige Kennzeichnung für den Kunden, z. B.C0123456
LANGUAGE_CODE
: ein akzeptierter Sprachcode, z. B.es
für Spanisch.
Bei einer erfolgreichen JSON-Antwort werden der HTTP-Statuscode 200
und die aktualisierte Kundenressource zurückgegeben:
{ "alternateEmail": "EMAIL_ADDRESS", "customerCreationTime": "2022-12-12T23:04:10.620Z", "customerDomain": "DOMAIN_NAME", "id": "CUSTOMER_ID", "kind": "admin#directory#customer", "language": "LANGUAGE_CODE", "postalAddress": { "contactName": "NAME", "countryCode": "COUNTRY_CODE", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE" } }