Importante:non accettiamo più nuove registrazioni per l'API Play EMM.
Scopri di più.
Enterprises: createWebToken
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce un token univoco per accedere a un'interfaccia utente incorporabile. Per generare un
nell'interfaccia utente web, passa il token generato al codice JavaScript della versione gestita di Google Play
tramite Google Cloud CLI
o tramite l'API Compute Engine. Ogni token può essere utilizzato solo per avviare una sessione dell'interfaccia utente. Consulta le
documentazione dell'API JavaScript per ulteriori informazioni.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
Parametri
Nome del parametro |
Valore |
Descrizione |
Parametri percorso |
enterpriseId |
string |
L'ID dell'azienda.
|
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
Nel corpo della richiesta, fornisci i dati con la seguente struttura:
{
"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
}
}
Nome proprietà |
Valore |
Descrizione |
Note |
permission[] |
list |
Deprecato. Usa PlaySearch.approveApps . |
|
parent |
string |
L'URI del frame principale che ospita l'iframe. Per evitare il rischio XSS, l'iframe potrebbe non essere ospitato su altri URI. L'URI deve essere https. Utilizza gli spazi vuoti per separare più URI principali. |
|
playSearch |
nested object |
Opzioni per la visualizzazione della pagina delle app della versione gestita di Play Search. |
|
playSearch.enabled |
boolean |
Se viene visualizzata la pagina delle app della versione gestita di Play Search. Il valore predefinito è true. |
|
playSearch.approveApps |
boolean |
Consenti l'accesso all'iframe in modalità di approvazione. Il valore predefinito è false. |
|
privateApps |
nested object |
Opzioni per la visualizzazione della pagina App private. |
|
privateApps.enabled |
boolean |
Se viene visualizzata la pagina App private. Il valore predefinito è true. |
|
webApps |
nested object |
Opzioni per la visualizzazione della pagina delle app web. |
|
webApps.enabled |
boolean |
Se la pagina delle app web viene visualizzata. Il valore predefinito è true. |
|
storeBuilder |
nested object |
Opzioni per la visualizzazione della pagina Organizza le app. |
|
storeBuilder.enabled |
boolean |
Indica se viene visualizzata la pagina Organizza app. Il valore predefinito è true. |
|
managedConfigurations |
nested object |
Opzioni per visualizzare la pagina Configurazione gestita. |
|
managedConfigurations.enabled |
boolean |
Se viene visualizzata la pagina Configurazione gestita. Il valore predefinito è true. |
|
kind |
string |
|
|
zeroTouch |
nested object |
Opzioni per la visualizzazione della pagina Zero Touch. |
|
zeroTouch.enabled |
boolean |
Indica se la UI zero-touch incorporata è utilizzabile con questo token. Se l'opzione viene attivata, l'amministratore può collegare i clienti zero-touch a questa azienda. |
|
Risposta
In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
Nome proprietà |
Valore |
Descrizione |
Note |
token |
string |
Un token opaco da passare al front-end di Google Play per generare un iframe. |
|
kind |
string |
|
|
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 2024-09-10 UTC.
[null,null,["Ultimo aggiornamento 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` | | |"]]