Method: partners.customers.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt einen Kunden für die Zero-Touch-Registrierung. Nachdem die Methode erfolgreich zurückgegeben wurde, können die Administrator- und Inhaberrollen Geräte und EMM-Konfigurationen verwalten, indem sie API-Methoden aufrufen oder ihr Portal für die Zero-Touch-Registrierung verwenden. Der Kunde erhält eine E-Mail, in der er zur Zero-Touch-Registrierung begrüßt wird und in der erklärt wird, wie er sich im Portal anmelden kann.
HTTP-Anfrage
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Die übergeordnete Ressourcen-ID im Format partners/[PARTNER_ID], die den Reseller identifiziert.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"customer": {
object (Company)
}
} |
| Felder |
customer |
object (Company)
Erforderlich. Die Unternehmensdaten, die für den neuen Kunden verwendet werden sollen. Muss einen Wert für companyName und mindestens einen Wert für owner_email enthalten, der mit einem Google-Konto verknüpft ist. Die Werte für companyId und name müssen leer sein.
|
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Company.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidworkprovisioning
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
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)."],[[["\u003cp\u003eThis endpoint creates a new customer for zero-touch enrollment, enabling them to manage devices and EMM configurations via API or the zero-touch portal.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e to \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers\u003c/code\u003e, using gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required and identifies the reseller in the format \u003ccode\u003epartners/[PARTNER_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003ecustomer\u003c/code\u003e object with the company name and at least one owner email associated with a Google Account.\u003c/p\u003e\n"],["\u003cp\u003eSuccessfully creating a customer returns a \u003ccode\u003eCompany\u003c/code\u003e instance, and the operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes how to create a zero-touch enrollment customer using a POST request to `https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers`. The `parent` path parameter specifies the reseller. The request body must include a `customer` object with a `companyName` and at least one `owner_email`. Upon success, a new `Company` instance is returned. Authorization requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope. The created customer can then manage devices and EMM configs.\n"],null,["# Method: partners.customers.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nCreates a customer for zero-touch enrollment. After the method returns successfully, admin and owner roles can manage devices and EMM configs by calling API methods or using their zero-touch enrollment portal. The customer receives an email that welcomes them to zero-touch enrollment and explains how to sign into the portal.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource ID in the format `partners/[PARTNER_ID]` that identifies the reseller. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------|---|\n| ``` { \"customer\": { object (/zero-touch/reference/reseller/rest/v1/partners.customers#Company) } } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `object (`[Company](/zero-touch/reference/reseller/rest/v1/partners.customers#Company)`)` Required. The company data to populate the new customer. Must contain a value for `companyName` and at least one `owner_email` that's associated with a Google Account. The values for `companyId` and `name` must be empty. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Company](/zero-touch/reference/reseller/rest/v1/partners.customers#Company).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
