Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play.
En savoir plus
Enterprises: generateSignupUrl
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Génère une URL d'inscription.
Requête
Requête HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/signupUrl
Paramètres
| Nom du paramètre |
Valeur |
Description |
| Paramètres de requête facultatifs |
adminEmail |
string |
Facultatif. Adresse e-mail utilisée pour préremplir le champ "Admin" du formulaire d'inscription à l'entreprise. Cette valeur n'est qu'une suggestion et peut être modifiée par l'utilisateur.
Si "allowedDomains" n'est pas vide, il doit appartenir à l'un des "allowedDomains".
|
allowedDomains |
string |
Facultatif. Liste des domaines autorisés pour l'adresse e-mail de l'administrateur. L'administrateur informatique ne peut pas saisir d'adresse e-mail avec un nom de domaine qui ne figure pas dans cette liste. Les sous-domaines des domaines de cette liste ne sont pas autorisés, mais peuvent l'être en ajoutant une deuxième entrée avec le préfixe "*." au nom de domaine (par exemple, *.example.com). Si le champ n'est pas présent ou s'il s'agit d'une liste vide, l'administrateur informatique est libre d'utiliser n'importe quel nom de domaine valide. Les domaines de messagerie personnelle sont toujours autorisés, mais ils entraînent la création d'un compte d'entreprise Google Play Accounts géré.
|
callbackUrl |
string |
URL de rappel vers laquelle l'administrateur sera redirigé après avoir créé une entreprise. Avant de rediriger l'utilisateur vers cette URL, le système ajoute un seul paramètre de requête nommé "enterpriseToken", qui contient un jeton opaque à utiliser pour la requête CompleteSignup.
Notez que cela signifie que l'URL sera analysée, le paramètre ajouté, puis une nouvelle URL formatée. Autrement dit, il peut y avoir des modifications mineures de mise en forme et, plus important encore, l'URL doit être bien formatée pour pouvoir être analysée.
|
Autorisation
Cette requête nécessite une autorisation ayant la portée suivante:
| Champ d'application |
|---|
https://www.googleapis.com/auth/androidenterprise |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"kind": string,
"url": string,
"completionToken": string
}
| Nom de propriété |
Valeur |
Description |
Remarques |
url |
string |
URL sous laquelle l'administrateur peut s'inscrire pour une entreprise. La page pointée ne peut pas être affichée dans un iFrame. |
|
completionToken |
string |
Jeton opaque qui sera requis, avec le jeton d'entreprise, pour obtenir la ressource d'entreprise à partir de CompleteSignup. |
|
kind |
string |
Obsolète.
|
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/03/27 (UTC).
[null,null,["Dernière mise à jour le 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. | |"]]
