Method: customers.insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Er bestellt das Konto eines neuen Kunden.
Bevor du ein neues Kundenkonto bestellst, solltest du mithilfe der customers.get prüfen, ob das Kundenkonto bereits vorhanden ist.
Wenn das Kundenkonto als direktes Google-Konto oder als weiterverkauftes Kundenkonto eines anderen Resellers vorhanden ist, verwende die customerAuthToken\ wie unter Weiterverkauftes Konto für einen bestehenden Kunden bestellen beschrieben. Weitere Informationen zum Bestellen eines neuen Kundenkontos finden Sie unter Neues Kundenkonto bestellen.
Nachdem Sie ein neues Kundenkonto erstellt haben, müssen Sie einen Nutzer als Administrator einrichten. Der Administrator des Kunden muss sich in der Admin-Konsole anmelden und die G Suite-Resellervereinbarung unterzeichnen, um das Konto zu aktivieren. Reseller dürfen die G Suite-Vereinbarung nicht im Namen des Kunden unterzeichnen. Weitere Informationen finden Sie unter Neues Kundenkonto bestellen.
HTTP-Anfrage
POST https://reseller.googleapis.com/apps/reseller/v1/customers
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
customerAuthToken |
string
Der customerAuthToken-Suchstring ist erforderlich, wenn Sie ein Reseller-Konto erstellen, über das das Abo eines Direktkunden oder das Abo eines anderen Reseller-Kunden an Ihre Reseller-Verwaltung übertragen wird. Dies ist ein hexadezimales Authentifizierungstoken, das für die Übertragung des Abos erforderlich ist. Weitere Informationen finden Sie in der Administratorhilfe.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Customer.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Customer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/apps.order
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: customers.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nOrders a new customer's account.\n\nBefore ordering a new customer account, establish whether the customer account already exists using the [`customers.get`](https://developers.google.com/workspace/admin/reseller/v1/reference/customers/get)\n\nIf the customer account exists as a direct Google account or as a resold customer account from another reseller, use the `customerAuthToken\\` as described in [order a resold account for an existing customer](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_existing_customer). For more information about ordering a new customer account, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_customer).\n\nAfter creating a new customer account, you must provision a user as an administrator. The customer's administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer's behalf. For more information, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#tos).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
