Importante: não aceitamos mais novos registros para a API Play EMM.
Saiba mais.
Enterprises: createWebToken
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Retorna um token exclusivo para acessar uma interface incorporável. Para gerar um
da IU da Web, transmita o token gerado ao JavaScript do Google Play gerenciado.
API. Cada token só pode ser usado para iniciar uma sessão de interface. Consulte a
documentação da API JavaScript para mais informações.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
Parâmetros
Nome do parâmetro |
Valor |
Descrição |
Parâmetros de caminho |
enterpriseId |
string |
O ID da empresa.
|
Autorização
Esta solicitação requer autorização com o seguinte escopo:
Escopo |
https://www.googleapis.com/auth/androidenterprise |
Para mais informações, consulte a página de autenticação e autorização.
Corpo da solicitação
No corpo da solicitação, forneça os dados com a seguinte estrutura:
{
"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 da propriedade |
Valor |
Descrição |
Observações |
permission[] |
list |
Obsoleto. Use PlaySearch.approveApps . |
|
parent |
string |
O URI do frame pai que hospeda o iframe. Para evitar XSS, o iframe pode não estar hospedado em outros URIs. Esse URI precisa ser HTTPS. Use espaços em branco para separar vários URIs pai. |
|
playSearch |
nested object |
Opções para exibir a página de apps de pesquisa do Google Play gerenciado. |
|
playSearch.enabled |
boolean |
Indica se a página de apps de pesquisa do Google Play gerenciado é exibida. O padrão é verdadeiro. |
|
playSearch.approveApps |
boolean |
Permita o acesso ao iframe no modo de aprovação. O padrão é false |
|
privateApps |
nested object |
Opções para exibir a página "Apps particulares". |
|
privateApps.enabled |
boolean |
Define se a página "Apps particulares" será exibida. O padrão é verdadeiro. |
|
webApps |
nested object |
Opções para exibir a página "Apps da Web". |
|
webApps.enabled |
boolean |
Se a página de apps da Web é exibida. O padrão é verdadeiro. |
|
storeBuilder |
nested object |
Opções para exibir a página "Organizar apps". |
|
storeBuilder.enabled |
boolean |
Indica se a página "Organizar apps" será exibida. O padrão é verdadeiro. |
|
managedConfigurations |
nested object |
Opções para exibir a página "Configuração gerenciada". |
|
managedConfigurations.enabled |
boolean |
Indica se a página "Configuração gerenciada" é exibida. O padrão é verdadeiro. |
|
kind |
string |
|
|
zeroTouch |
nested object |
Opções para mostrar a página do registro sem toque. |
|
zeroTouch.enabled |
boolean |
Se a interface incorporada de registro sem toque pode ser usada com esse token. Se ativado, o administrador poderá vincular clientes sem toque a esta empresa. |
|
Resposta
Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
Nome da propriedade |
Valor |
Descrição |
Observações |
token |
string |
Um token opaco que vai ser transmitido ao front-end do Google Play para gerar um iframe. |
|
kind |
string |
|
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-10 UTC.
[null,null,["Última atualização 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` | | |"]]