Enterprises: createWebToken
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
삽입 가능한 UI에 액세스하기 위한 고유 토큰을 반환합니다. 생성 시
관리 Google Play JavaScript에 생성된 토큰을 전달합니다.
API에 액세스할 수 있습니다. 각 토큰은 하나의 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 |
관리 Play 검색 앱 페이지를 표시하는 옵션입니다. |
|
playSearch.enabled |
boolean |
Managed Play 검색 앱 페이지 표시 여부 기본값은 true입니다. |
|
playSearch.approveApps |
boolean |
승인 모드에서 iframe 액세스를 허용합니다. 기본값은 false입니다. |
|
privateApps |
nested object |
비공개 앱 페이지를 표시하기 위한 옵션입니다. |
|
privateApps.enabled |
boolean |
비공개 앱 페이지 표시 여부입니다. 기본값은 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 |
|
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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` | | |"]]