Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API.
Więcej informacji
Enterprises: createWebToken
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zwraca unikalny token, aby uzyskać dostęp do interfejsu z możliwością umieszczania. Aby wygenerować
interfejsu internetowego, przekaż wygenerowany token do kodu JavaScript zarządzanego Sklepu Google Play
API. Każdego tokena można użyć tylko do uruchomienia 1 sesji interfejsu użytkownika. Zobacz
dokumentacji JavaScript API.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
Parametry
Nazwa parametru |
Wartość |
Opis |
Parametry ścieżki |
enterpriseId |
string |
Identyfikator grupy.
|
Autoryzacja
To żądanie wymaga autoryzacji w tym zakresie:
Zakres |
https://www.googleapis.com/auth/androidenterprise |
Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.
Treść żądania
Dane w treści żądania muszą mieć poniższy format:
{
"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
}
}
Nazwa usługi |
Wartość |
Opis |
Uwagi |
permission[] |
list |
Rola wycofana. Użyj konta PlaySearch.approveApps . |
|
parent |
string |
Identyfikator URI nadrzędnej ramki hostującej element iframe. Aby zapobiec atakom XSS, element iframe nie może być hostowany pod innymi identyfikatorami URI. Ten identyfikator URI musi zaczynać się od HTTPS. Oddzielaj wiele nadrzędnych identyfikatorów URI spacjami. |
|
playSearch |
nested object |
Opcje wyświetlania strony aplikacji zarządzanego wyszukiwania w Google Play. |
|
playSearch.enabled |
boolean |
Określa, czy jest wyświetlana strona aplikacji zarządzanego wyszukiwania w Sklepie Play. Wartość domyślna to true (prawda). |
|
playSearch.approveApps |
boolean |
Zezwalaj na dostęp do elementu iframe w trybie zatwierdzania. Wartość domyślna to false (fałsz). |
|
privateApps |
nested object |
Opcje wyświetlania strony Aplikacje prywatne. |
|
privateApps.enabled |
boolean |
Określa, czy wyświetla się strona Aplikacje prywatne. Wartość domyślna to true (prawda). |
|
webApps |
nested object |
Opcje wyświetlania strony aplikacji internetowych. |
|
webApps.enabled |
boolean |
Określa, czy wyświetlana jest strona aplikacji internetowych. Wartość domyślna to true (prawda). |
|
storeBuilder |
nested object |
Opcje wyświetlania strony Uporządkuj aplikacje. |
|
storeBuilder.enabled |
boolean |
Określa, czy wyświetla się strona Uporządkuj aplikacje. Wartość domyślna to true (prawda). |
|
managedConfigurations |
nested object |
Opcje wyświetlania strony konfiguracji zarządzanej. |
|
managedConfigurations.enabled |
boolean |
Określa, czy wyświetlana jest strona konfiguracji zarządzanej. Wartość domyślna to true (prawda). |
|
kind |
string |
|
|
zeroTouch |
nested object |
Opcje wyświetlania strony rejestracji typu zero-touch. |
|
zeroTouch.enabled |
boolean |
Określa, czy umieszczony interfejs typu zero-touch może być używany z tym tokenem. Jeśli ta opcja jest włączona, administrator może powiązać klientów korzystających z rejestracji typu zero-touch z tą firmą. |
|
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
Nazwa usługi |
Wartość |
Opis |
Uwagi |
token |
string |
Nieprzezroczysty token przekazywany do interfejsu Play w celu wygenerowania elementu iframe. |
|
kind |
string |
|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-09-10 UTC.
[null,null,["Ostatnia aktualizacja: 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` | | |"]]