Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play.
En savoir plus
Enterprises: createWebToken
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie un jeton unique permettant d'accéder à une interface utilisateur intégrable. Pour générer une
UI Web, transmettez le jeton généré au code JavaScript Google Play d'entreprise
API. Chaque jeton ne peut être utilisé que pour démarrer une seule session d'interface utilisateur. Consultez le
la documentation de l'API JavaScript.
Requête
Requête HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
Paramètres
Nom du paramètre |
Valeur |
Description |
Paramètres de chemin d'accès |
enterpriseId |
string |
ID de l'entreprise.
|
Autorisation
Cette requête nécessite une autorisation ayant le champ d'application suivant:
Champ d'application |
https://www.googleapis.com/auth/androidenterprise |
Pour en savoir plus, consultez la page Authentification et autorisation.
Corps de la requête
Dans le corps de la requête, fournissez les données selon la structure suivante:
{
"kind": "androidenterprise#administratorWebTokenSpec",
"permission": [
string
],
"parent": string,
"playSearch": {
"enabled": boolean,
"approveApps": boolean
},
"privateApps": {
"enabled": boolean
},
"webApps": {
"enabled": boolean
},
"storeBuilder": {
"enabled": boolean
},
"managedConfigurations": {
"enabled": boolean
},
"zeroTouch": {
"enabled": boolean
}
}
Nom de propriété |
Valeur |
Description |
Remarques |
permission[] |
list |
Obsolète. Utilisez PlaySearch.approveApps . |
|
parent |
string |
L'URI du cadre parent hébergeant l'iFrame. Pour éviter les attaques XSS, l'iFrame ne doit pas être hébergé sur d'autres URI. Cet URI doit être HTTPS. Utilisez des espaces blancs pour séparer plusieurs URI parents. |
|
playSearch |
nested object |
Options d'affichage de la page des applications de recherche Google Play d'entreprise. |
|
playSearch.enabled |
boolean |
Indique si la page des applications de recherche Google Play d'entreprise est affichée. La valeur par défaut est "true". |
|
playSearch.approveApps |
boolean |
Autorisez l'accès à l'iFrame en mode Approbation. La valeur par défaut est "false". |
|
privateApps |
nested object |
Options d'affichage de la page "Applications privées". |
|
privateApps.enabled |
boolean |
Indique si la page "Applications privées" est affichée. La valeur par défaut est "true". |
|
webApps |
nested object |
Options d'affichage de la page des applications Web |
|
webApps.enabled |
boolean |
Indique si la page des applications Web est affichée. La valeur par défaut est "true". |
|
storeBuilder |
nested object |
Options d'affichage de la page "Organiser les applications" |
|
storeBuilder.enabled |
boolean |
Indique si la page "Organiser les applications" est affichée. La valeur par défaut est "true". |
|
managedConfigurations |
nested object |
Options d'affichage de la page "Configuration gérée" |
|
managedConfigurations.enabled |
boolean |
Indique si la page "Configuration gérée" s'affiche. La valeur par défaut est "true". |
|
kind |
string |
|
|
zeroTouch |
nested object |
Options d'affichage de la page "Sans contact". |
|
zeroTouch.enabled |
boolean |
Indique si l'interface utilisateur intégrée sans contact est utilisable avec ce jeton. Si cette option est activée, l'administrateur peut associer les clients sans contact à cette entreprise. |
|
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
Nom de propriété |
Valeur |
Description |
Remarques |
token |
string |
Jeton opaque à transmettre à l'interface Play pour générer un iFrame. |
|
kind |
string |
|
|
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 2024/09/10 (UTC).
[null,null,["Dernière mise à jour le 2024/09/10 (UTC)."],[[["\u003cp\u003eGenerates a unique token for accessing an embeddable UI for managing Google Play apps in an enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body allows customization of which pages are displayed in the UI, such as Play Search, Private Apps, and Web Apps.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an opaque token to be used with the managed Google Play javascript API to generate the UI iframe.\u003c/p\u003e\n"],["\u003cp\u003eThe token is single-use and intended for one UI session only.\u003c/p\u003e\n"]]],[],null,["# Enterprises: createWebToken\n\n| **Note:** Requires [authorization](#auth).\n\nReturns a unique token to access an embeddable UI. To generate a\nweb UI, pass the generated token into the managed Google Play javascript\nAPI. Each token may only be used to start one UI session. See the\n[JavaScript API documentation](https://developers.google.com/api-client-library/javascript/apis/androidenterprise/v1) for further information.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\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\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#administratorWebTokenSpec\",\n \"permission\": [\n string\n ],\n \"parent\": string,\n \"playSearch\": {\n \"enabled\": boolean,\n \"approveApps\": boolean\n },\n \"privateApps\": {\n \"enabled\": boolean\n },\n \"webApps\": {\n \"enabled\": boolean\n },\n \"storeBuilder\": {\n \"enabled\": boolean\n },\n \"managedConfigurations\": {\n \"enabled\": boolean\n },\n \"zeroTouch\": {\n \"enabled\": boolean\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `permission[]` | `list` | Deprecated. Use `PlaySearch.approveApps`. | |\n| `parent` | `string` | The URI of the parent frame hosting the iframe. To prevent XSS, the iframe may not be hosted at other URIs. This URI must be https. Use whitespaces to separate multiple parent URIs. | |\n| `playSearch` | `nested object` | Options for displaying the managed Play Search apps page. | |\n| playSearch.`enabled` | `boolean` | Whether the managed Play Search apps page is displayed. Default is true. | |\n| playSearch.`approveApps` | `boolean` | Allow access to the iframe in [approve mode](https://developers.google.com/android/work/play/emm-api/managed-play-iframe#render). Default is false. | |\n| `privateApps` | `nested object` | Options for displaying the Private Apps page. | |\n| privateApps.`enabled` | `boolean` | Whether the Private Apps page is displayed. Default is true. | |\n| `webApps` | `nested object` | Options for displaying the Web Apps page. | |\n| webApps.`enabled` | `boolean` | Whether the Web Apps page is displayed. Default is true. | |\n| `storeBuilder` | `nested object` | Options for displaying the Organize apps page. | |\n| storeBuilder.`enabled` | `boolean` | Whether the Organize apps page is displayed. Default is true. | |\n| `managedConfigurations` | `nested object` | Options for displaying the Managed Configuration page. | |\n| managedConfigurations.`enabled` | `boolean` | Whether the Managed Configuration page is displayed. Default is true. | |\n| `kind` | `string` | | |\n| `zeroTouch` | `nested object` | Options for displaying the Zero Touch page. | |\n| zeroTouch.`enabled` | `boolean` | Whether zero-touch embedded UI is usable with this token. If enabled, the admin can link zero-touch customers to this enterprise. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"androidenterprise#administratorWebToken\",\n \"token\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|---------------------------------------------------------------------------|-------|\n| `token` | `string` | An opaque token to be passed to the Play front-end to generate an iframe. | |\n| `kind` | `string` | | |"]]