重要: Play EMM API の新しい登録受け付けは終了しました。
詳細
Enterprises: createWebToken
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
埋め込み可能な UI にアクセスするための一意のトークンを返します。生成
生成されたトークンを managed Google Play JavaScript に渡す
API各トークンは 1 つの UI セッションを開始するためにのみ使用できます。詳しくは、
JavaScript API ドキュメントをご覧ください。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/createWebToken
パラメータ
パラメータ名 |
値 |
説明 |
パスパラメータ |
enterpriseId |
string |
企業の ID。
|
承認
このリクエストには、次のスコープによる認証が必要です。
スコープ |
https://www.googleapis.com/auth/androidenterprise |
詳細については、認証と認可のページをご覧ください。
リクエスト本文
リクエストの本文には、以下の構造を使用してデータを指定してください。
{
"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
}
}
プロパティ名 |
値 |
説明 |
メモ |
permission[] |
list |
非推奨です。PlaySearch.approveApps を使用します。 |
|
parent |
string |
iframe をホストする親フレームの URI。XSS を防ぐために、iframe を他の URI でホストすることはできません。URI は https にする必要があります。複数の親 URI は空白文字で区切ります。 |
|
playSearch |
nested object |
managed Play 検索アプリのページを表示するためのオプション。 |
|
playSearch.enabled |
boolean |
managed Play アプリの検索ページを表示するかどうかを指定します。デフォルトは true です。 |
|
playSearch.approveApps |
boolean |
承認モードで iframe へのアクセスを許可します。デフォルトは false です。 |
|
privateApps |
nested object |
[Private Apps] ページを表示するためのオプション。 |
|
privateApps.enabled |
boolean |
[Private Apps] ページを表示するかどうか。デフォルトは true です。 |
|
webApps |
nested object |
[ウェブアプリ] ページを表示するためのオプション。 |
|
webApps.enabled |
boolean |
[ウェブアプリ] ページを表示するかどうかを指定します。デフォルトは true です。 |
|
storeBuilder |
nested object |
[アプリの整理] ページを表示するためのオプション。 |
|
storeBuilder.enabled |
boolean |
[アプリの整理] ページを表示するかどうか。デフォルトは true です。 |
|
managedConfigurations |
nested object |
[管理対象設定] ページを表示するためのオプション。 |
|
managedConfigurations.enabled |
boolean |
[管理対象設定] ページを表示するかどうかを指定します。デフォルトは true です。 |
|
kind |
string |
|
|
zeroTouch |
nested object |
ゼロタッチ ページを表示するためのオプション。 |
|
zeroTouch.enabled |
boolean |
このトークンでゼロタッチ埋め込み UI を使用できるかどうか。有効にした場合、管理者はゼロタッチ登録の顧客をこの企業にリンクできます。 |
|
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{
"kind": "androidenterprise#administratorWebToken",
"token": string
}
プロパティ名 |
値 |
説明 |
メモ |
token |
string |
iframe を生成するために Play フロントエンドに渡される不透明トークン。 |
|
kind |
string |
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-09-10 UTC。
[null,null,["最終更新日 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` | | |"]]