Method: partners.customers.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea un cliente per la registrazione zero-touch. Una volta restituito il metodo, i ruoli di amministratore e proprietario possono gestire i dispositivi e le configurazioni EMM chiamando metodi API o utilizzando il portale di registrazione zero-touch. Il cliente riceve un'email di benvenuto alla registrazione zero-touch e spiega come accedere al portale.
Richiesta HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. L'ID risorsa padre nel formato partners/[PARTNER_ID] che identifica il rivenditore.
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"customer": {
object (Company)
}
} |
| Campi |
customer |
object (Company)
Obbligatorio. I dati aziendali da inserire nel nuovo cliente. Deve contenere un valore per companyName e almeno un owner_email associato a un Account Google. I valori per companyId e name devono essere vuoti.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Company appena creata.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidworkprovisioning
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
