Importante:non accettiamo più nuove registrazioni per l'API Play EMM.
Scopri di più.
Enterprises: generateSignupUrl
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Genera un URL di registrazione.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Parametri
| Nome parametro |
Valore |
Descrizione |
| Parametri di query facoltativi |
adminEmail |
string |
Facoltativo. Indirizzo email utilizzato per compilare automaticamente il campo amministratore del modulo di registrazione di Enterprise. Questo valore è solo un suggerimento e può essere modificato dall'utente.
Se "allowedDomains" non è vuoto, deve appartenere a uno dei "allowedDomains".
|
allowedDomains |
string |
Facoltativo. Un elenco di domini consentiti per l'email di amministrazione. L'amministratore IT non può inserire un indirizzo email con un nome di dominio non presente in questo elenco. I sottodomini dei domini in questo elenco non sono consentiti, ma possono essere autorizzati aggiungendo una seconda voce con il prefisso "*." al nome di dominio (ad es. *.example.com). Se il campo non è presente o è un elenco vuoto,
l'amministratore IT è libero di utilizzare qualsiasi nome di dominio valido. I domini email personali sono sempre consentiti, ma ne deriverà la creazione di account Google Play gestiti per l'azienda.
|
callbackUrl |
string |
L'URL di callback a cui l'amministratore verrà reindirizzato dopo aver creato correttamente un'azienda. Prima di reindirizzare a questo URL, il sistema aggiungerà un singolo parametro di query denominato "enterpriseToken" che conterrà un token opaco da utilizzare per la richiesta CompleteSignup.
Tieni presente che ciò significa che l'URL verrà analizzato, il parametro verrà aggiunto
e poi verrà formattato un nuovo URL, ovvero potrebbero esserci alcune modifiche minori alla formattazione
e, soprattutto, l'URL deve essere ben formato in modo da poter essere analizzata.
|
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
| Ambito |
|---|
https://www.googleapis.com/auth/androidenterprise |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Non specificare un corpo della richiesta con questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": string,
"url": string,
"completionToken": string
}
| Nome proprietà |
Valore |
Descrizione |
Note |
url |
string |
Un URL con cui l'amministratore può registrarsi a un'azienda. La pagina a cui si fa riferimento non può essere visualizzata in un iframe. |
|
completionToken |
string |
Un token opaco che sarà necessario, insieme al token dell'azienda, per ottenere la risorsa dell'azienda da CompleteSignup. |
|
kind |
string |
Ritirato.
|
|
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-03-27 UTC.
[null,null,["Ultimo aggiornamento 2025-03-27 UTC."],[[["\u003cp\u003eGenerates a sign-up URL for Android enterprise enrollment using the \u003ccode\u003esignupUrl\u003c/code\u003e endpoint with an optional admin email and callback URL.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signup, a response provides a sign-up URL for the admin and a completion token for finalizing the process with the \u003ccode\u003eCompleteSignup\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary to use this endpoint.\u003c/p\u003e\n"]]],[],null,["# Enterprises: generateSignupUrl\n\n| **Note:** Requires [authorization](#auth).\n\nGenerates a sign-up URL.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|------------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `adminEmail` | `string` | Optional. Email address used to prefill the admin field of the enterprise signup form. This value is a hint only and can be altered by the user. If \\`allowedDomains\\` is non-empty then this must belong to one of the \\`allowedDomains\\`. |\n| `allowedDomains` | `string` | Optional. A list of domains that are permitted for the admin email. The IT admin cannot enter an email address with a domain name that is not in this list. Subdomains of domains in this list are not allowed but can be allowed by adding a second entry which has \\`\\*.\\` prefixed to the domain name (e.g. \\*.example.com). If the field is not present or is an empty list then the IT admin is free to use any valid domain name. Personal email domains are always allowed, but will result in the creation of a managed Google Play Accounts enterprise. |\n| `callbackUrl` | `string` | The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named \"enterpriseToken\" which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": string,\n \"url\": string,\n \"completionToken\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `url` | `string` | A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe. | |\n| `completionToken` | `string` | An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup. | |\n| `kind` | `string` | Deprecated. | |"]]
