Enterprises: createWebToken
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt ein eindeutiges Token für den Zugriff auf eine einbettbare UI zurück. Um eine
Web-UI, übergeben Sie das generierte Token an das Managed Google Play-JavaScript
der API erstellen. Jedes Token kann nur zum Starten einer UI-Sitzung verwendet werden. Weitere Informationen finden Sie in der
JavaScript API-Dokumentation.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
Parameter
Parametername |
Wert |
Beschreibung |
Pfadparameter |
enterpriseId |
string |
Die ID des Unternehmens.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:
Umfang |
https://www.googleapis.com/auth/androidenterprise |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:
{
"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
}
}
Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
permission[] |
list |
Verworfen. Verwenden Sie PlaySearch.approveApps . |
|
parent |
string |
Der URI des übergeordneten Frames, in dem der iFrame gehostet wird. Um XSS zu verhindern, darf der iFrame nicht auf anderen URIs gehostet werden. Dieser URI muss „https“ sein. Trennen Sie mehrere übergeordnete URIs durch Leerzeichen. |
|
playSearch |
nested object |
Optionen zum Anzeigen der Seite mit den Apps in der Managed Play Store-Suche. |
|
playSearch.enabled |
boolean |
Gibt an, ob die Seite mit den Apps in der Managed Play Store-Suche angezeigt wird. Standardwert ist True. |
|
playSearch.approveApps |
boolean |
Erlauben Sie den Zugriff auf den iFrame im Genehmigungsmodus. Der Standardwert ist "false". |
|
privateApps |
nested object |
Optionen zum Anzeigen der Seite „Private Apps“. |
|
privateApps.enabled |
boolean |
Ob die Seite „Private Apps“ angezeigt wird Standardwert ist True. |
|
webApps |
nested object |
Optionen zum Anzeigen der Web-Apps-Seite. |
|
webApps.enabled |
boolean |
Gibt an, ob die Web-Apps-Seite angezeigt wird. Standardwert ist True. |
|
storeBuilder |
nested object |
Optionen zum Anzeigen der Seite „Apps organisieren“. |
|
storeBuilder.enabled |
boolean |
Gibt an, ob die Seite „Apps organisieren“ angezeigt wird. Standardwert ist True. |
|
managedConfigurations |
nested object |
Optionen zum Anzeigen der Seite „Verwaltete Konfiguration“. |
|
managedConfigurations.enabled |
boolean |
Ob die Seite „Verwaltete Konfiguration“ angezeigt wird. Standardwert ist True. |
|
kind |
string |
|
|
zeroTouch |
nested object |
Optionen zum Anzeigen der Zero-Touch-Seite. |
|
zeroTouch.enabled |
boolean |
Gibt an, ob die eingebettete Zero-Touch-Benutzeroberfläche mit diesem Token verwendet werden kann. Wenn diese Option aktiviert ist, kann der Administrator Zero-Touch-Kunden mit diesem Unternehmen verknüpfen. |
|
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
Name der Eigenschaft |
Wert |
Beschreibung |
Hinweise |
token |
string |
Ein intransparentes Token, das an das Play-Frontend übergeben wird, um einen iFrame zu generieren. |
|
kind |
string |
|
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-10 (UTC).
[null,null,["Zuletzt aktualisiert: 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` | | |"]]