Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Beachten Sie vor dem Erstellen eines neuen Kundenkontos Folgendes:
Möglicherweise gelten Einschränkungen für Ländercodes. Ob das Land des Kunden für den Weiterverkauf zugelassen ist, können Sie in der Partner Sales Console prüfen.
Verwenden Sie zum Erstellen eines Kundenkontos die folgende POST-Anfrage und fügen Sie das Autorisierungstoken ein:
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, ist die customerId bereits vorhanden. Bevor Sie das Kundenkonto registrieren, müssen Sie die Abos des Kunden übertragen.
Weisen Sie dem Nutzer die Rolle „Super Admin“ zu.
Beim Erstellen des Administratorkontos können Sie entweder ein temporäres zufälliges Passwort generieren oder den Kunden auffordern, ein Passwort anzugeben.
Informieren Sie den Kunden, dass er sich in der Admin-Konsole anmelden und die Google Workspace-Vereinbarung über Reseller unterzeichnen muss, um sein Konto zu aktivieren. Reseller dürfen die Nutzungsbedingungen nicht im Namen des Kunden unterzeichnen.
Kundentypen
Sie können zwei Arten von Kunden in Google Workspace erstellen:
Kunden mit bestätigter Domain: Diese Kunden benötigen Gmail und vollen Administratorzugriff. Wenn Sie diesen Kundentyp erstellen, legen Sie customerType auf domain fest.
Kunden mit bestätigter E-Mail-Adresse Diese Kunden sind nicht Inhaber ihrer Domain und verwalten sie auch nicht. Wenn Sie diesen Kundentyp erstellen, legen Sie customerType auf team fest. Diese Kunden können die Google Workspace-Versionen Essentials und Enterprise Essentials erwerben.
Der folgende JSON-Anfragetext ist ein Beispiel für einen domainbestätigten Kunden:
Die Standardsprache eines Kunden wird nur auf neue Nutzer angewendet, wenn sie erstellt werden. Für bestehende Nutzer wird die aktuelle Sprache beibehalten, auch wenn Sie die Standardsprache aktualisieren. Daher müssen Sie die Standardsprache des Kunden festlegen, bevor Sie Nutzer erstellen.
Für neu erstellte Kunden wird standardmäßig Englisch als Sprache festgelegt. Wenn Sie die Standardsprache ändern möchten, verwenden Sie die Aufrufe PATCH oder UPDATE über den Directory API-Endpunkt Customers.
Verwenden Sie die Directory API, um den Standardwert für language für einen Kunden zu aktualisieren:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["# Order a new customer account\n\nBefore you create a new customer account, consider the following:\n\n- Country code restrictions might apply. To confirm that the customer's country is approved for resale, check [the Partner Sales Console](https://channelservices.cloud.google.com/).\n- If the account is created by upgrading from a consumer Gmail account to a business email with a domain name, make sure that the account has additional Google Workspace settings unlocked. For more information, see [Create business emails for your team](https://support.google.com/work/mail/faq/6233331#6241806) and [Create a business email alias](https://support.google.com/work/mail/faq/6233331#6243069).\n\nCreate a customer account\n-------------------------\n\n1. To create a customer account, use the following `POST` request and\n include the authorization token:\n\n POST https://reseller.googleapis.com/apps/reseller/v1/customers\n\n2. Within the new customer's account,\n [create a user](/workspace/admin/directory/v1/guides/manage-users#create_user).\n If the response returns an HTTP `409 Conflict` status code, the\n `customerId` already exists. Before registering the customer account, you must\n [transfer the customer's subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n3. If applicable, [change the customer's default launguage](#change_a_customers_default_language).\n\n4. Promote the\n [user to the super administrator role](/workspace/admin/directory/v1/guides/manage-users#make_admin).\n When creating the administrator account, you can either generate a temporary\n random password or prompt the customer to provide a password.\n\n5. Notify the customer that they must sign-in to the Admin console and\n sign the Google Workspace via Reseller agreement in order to activate\n their account. Resellers are prohibited from signing the Terms of Service on\n the customer's behalf.\n\n### Types of customers\n\nYou can create two kinds of customers on Google Workspace:\n\n- **Domain-verified customers** . These customers need Gmail and need full administrator access. When you create this type of customer, set the `customerType` to `domain`.\n- **Email-verified customers** . These customers don't own or manage their domain. When you create this type of customer, set the `customerType` to `team`. These type of customers can purchase the [Essentials and Enterprise Essentials](https://support.google.com/channelservices/answer/9398241?ref_topic=9755957) editions of Google Workspace.\n\nThe following JSON request body is an example of a domain-verified customer: \n\n```\n{\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"domain\",\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\"\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eDOMAIN_NAME\u003c/var\u003e: your customer's domain---for example, `example.com`\n- \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e: your customer's name---for example, `Alex Cruz`.\n- \u003cvar translate=\"no\"\u003eORGANIZATION_NAME\u003c/var\u003e: your customer's organization name---for example, `Example Organization`.\n- \u003cvar translate=\"no\"\u003ePOSTAL_CODE\u003c/var\u003e: your customer's ZIP or postal code---for example, `94043`.\n- \u003cvar translate=\"no\"\u003eCOUNTRY_CODE\u003c/var\u003e: your customer's 2 character [ISO country code](https://countrycode.org/).\n- \u003cvar translate=\"no\"\u003eEMAIL_ADDRESS\u003c/var\u003e: your customer's email address---for example, `cruz@example.com`.\n\nA successful response returns an HTTP `200` status code and the new customer's\ninformation: \n\n```\n{\n \"kind\": \"reseller#customer\",\n \"customerId\": \"CUSTOMER_ID\",\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"domain\",\n \"postalAddress\": {\n \"kind\": \"customers#address\",\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\",\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nThe following JSON request body is an example of an email-verified customer: \n\n```\n{\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"team\",\n \"primaryAdmin\": {\n \"primaryEmail\": \"EMAIL_ADDRESS\"\n },\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\"\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nA successful response returns an HTTP `200` status code and the new customer's\ninformation: \n\n```\n{\n \"kind\": \"reseller#customer\",\n \"customerId\": \"CUSTOMER_ID\",\n \"customerDomain\": \"DOMAIN_NAME,\n \"customerType\": \"team\",\n \"primaryAdmin\": {\n \"primaryEmail\": \"EMAIL_ADDRESS\"\n },\n \"postalAddress\": {\n \"kind\": \"customers#address\",\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\",\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nChange a customer's default language\n------------------------------------\n\nA customer's default language is only applied to *new* users when they're\ncreated. Existing users retain their current language even after you\nupdate the default language. Therefore, you must set the customer default\nlanguage before you create any users.\n\nA newly created customer has a default language of English. To change the\ndefault language, use the\n[`PATCH`](/workspace/admin/directory/v1/reference/customers/patch)\nor\n[`UPDATE`](/workspace/admin/directory/v1/reference/customers/update)\ncalls from the Directory API\n[Customers](/workspace/admin/directory/v1/reference/customers)\nendpoint.\n\nUse the Directory API to update the default `language` value for a customer: \n\n```\nPATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID\n```\n\nInclude the following JSON request body: \n\n```\n{\n \"language\":\"LANGUAGE_CODE\"\n}\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCUSTOMER_ID\u003c/var\u003e: a unique identifier for your customer---for example, `C0123456`\n- \u003cvar translate=\"no\"\u003eLANGUAGE_CODE\u003c/var\u003e: an accepted [language code](/workspace/admin/directory/v1/languages) ---for example, `es` for Spanish.\n\nA successful JSON response returns an HTTP `200` status code and the updated\ncustomer resource: \n\n```\n{\n \"alternateEmail\": \"EMAIL_ADDRESS\",\n \"customerCreationTime\": \"2022-12-12T23:04:10.620Z\",\n \"customerDomain\": \"DOMAIN_NAME\",\n \"id\": \"CUSTOMER_ID\",\n \"kind\": \"admin#directory#customer\",\n \"language\": \"LANGUAGE_CODE\",\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"countryCode\": \"COUNTRY_CODE\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\"\n }\n}\n```\n\nNext steps\n----------\n\n- [Reseller API common errors](/workspace/admin/reseller/v1/support/reseller_api_common_errors)\n- [Directory API common errors](/workspace/admin/reseller/v1/support/directory_api_common_errors)"]]
