관리 Google Play iframe을 사용하여 관리 Google Play를 삽입할 수 있습니다. 직접 관리할 수 있어 고객에게 통합 모바일 관리 기능을 제공할 수 있습니다. 경험해 볼 수 있습니다
![관리 Google Play iframe](https://google-developers.gonglchuangl.net/static/android/work/play/emm-api/images/managed-google-play-iframe.png?authuser=0&hl=ko)
iframe에는 제목 표시줄과 확장 가능한 사이드 메뉴가 포함되어 있습니다. 메뉴에서 사용자가 다른 페이지로 이동할 수 있습니다.
- 앱 검색: IT 관리자가 Google을 검색하고 탐색할 수 있습니다. 앱 재생, 앱 세부정보 보기, 앱 선택
- 비공개 앱: IT 관리자가 비공개로 게시하고 관리하도록 허용합니다. 사용할 수 있습니다
- 웹 앱: IT 관리자가 웹사이트를 게시하고 배포할 수 있습니다. 바로 가기를 앱으로 사용할 수 있습니다.
- 앱 정리: IT 관리자가 앱 정리 방식을 구성할 수 있습니다. 사용자 기기의 Play 스토어 앱에 표시됩니다.
기본적으로 iframe에서 모든 페이지가 사용 설정되어 있지만 개별적으로 사용 중지할 수 있습니다. 콘솔에 iframe 추가 참고).
기능
이 섹션에서는 Managed Google Play iframe에서 사용할 수 있는 기능을 설명합니다. iframe을 삽입하고 이러한 기능을 구현하는 방법에 대한 자세한 내용은 다음을 참조하세요. 콘솔에 iframe 추가
콘솔에 iframe 추가
1단계: 웹 토큰 생성
기업을 식별하는 웹 토큰을 생성하려면 다음을 호출합니다.
Enterprises.createWebToken
다음 예는 Google Play EMM을 사용하여 토큰을 검색하는 방법을 보여줍니다.
Java용 API 클라이언트 라이브러리를 참조하세요.
iframe의 모든 페이지는 기본적으로 사용 설정되어 있습니다. 웹 토큰을 생성할 때 에서 사용 중지할 페이지를 지정할 수 있습니다. 아래 예에서는 비공개 앱을 사용 중지합니다. 웹 앱, 앱 정리를 선택합니다.
public AdministratorWebToken getAdministratorWebToken( String enterpriseId) throws IOException { AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec(); tokenSpec.setParent("https://my-emm-console.com"); tokenSpec.setPlaySearch(new AdministratorWebTokenSpecPlaySearch()); tokenSpec.setPrivateApps(new AdministratorWebTokenSpecPrivateApps().setEnabled(false)); tokenSpec.setWebApps(new AdministratorWebTokenSpecWebApps().setEnabled(false)); tokenSpec.setStoreBuilder(new AdministratorWebTokenSpecStoreBuilder().setEnabled(false)); return androidEnterprise .enterprise() .createWebToken(enterpriseId, tokenSpec) .execute(); }
다른 매개변수와 함께 반환된 토큰을 포함해야 하는 경우 렌더링하지 않습니다.
2단계. iframe 렌더링
다음은 관리 Play iframe을 렌더링하는 방법의 예입니다.
<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
gapi.load('gapi.iframes', function() {
var options = {
'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
'where': document.getElementById('container'),
'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
}
var iframe = gapi.iframes.getContext().openChild(options);
});
</script>
이 코드는 컨테이너 div
내에 iframe을 생성합니다. 특성
'속성' 속성을 사용하여 옵션을
참조하세요.
URL 매개변수
아래 표에는 URL에 추가할 수 있는 iframe에 사용할 수 있는 모든 매개변수가 나와 있습니다. 을 URL 매개변수로 사용할 수 있습니다.예:
'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
매개변수 | 페이지 | 필수 | 설명 |
---|---|---|---|
token |
해당 사항 없음 | 예 | 1단계에서 반환된 토큰 |
iframehomepage |
해당 사항 없음 | 아니요 | iframe이 렌더링될 때 표시되는 초기 페이지입니다. 가능한 값은 다음과 같습니다.
PLAY_SEARCH , WEB_APPS , PRIVATE_APPS , STORE_BUILDER (앱 정리) 지정하지 않으면 다음 순서
에 따라 표시되는 페이지가 결정됩니다. 1. PLAY_SEARCH , 2. PRIVATE_APPS , 3.
WEB_APPS , 4. STORE_BUILDER |
locale |
해당 사항 없음 | 아니요 | 올바른 형식의 BCP 47 언어 태그
지역화에 사용되는 언어입니다. 지정하지 않으면
기본값은 en_US 입니다.
|
mode |
앱 검색 | 아니요 |
SELECT : IT 관리자가 앱을 선택할 수 있습니다.APPROVE (기본값): IT 관리자가 앱을 선택, 승인, 승인 취소할 수 있도록 허용합니다.
|
showsearchbox |
앱 검색 | 아니요 | TRUE (기본값): 검색창을 표시하며
iframe 내에서 검색어를 시작합니다.FALSE :
검색창이 표시되지 않습니다.
|
search |
앱 검색 | 아니요 | 검색 문자열 지정하면 iframe은 IT 관리자에게
지정된 문자열입니다. |
3단계: iframe 이벤트 처리
통합의 일부로 다음 이벤트도 처리해야 합니다.
이벤트 | 설명 |
---|---|
onproductselect |
사용자가 앱을 선택하거나 승인합니다. 이 메서드는 다음을 포함하는 객체를 반환합니다.
{
"packageName": The package name of the app, e.g. "com.google.android.gm",
"productId": The product ID of the app, e.g. "app:com.google.android.gm",
"action": The type of action performed on the document. Possible values are:
"approved", "unapproved" or "selected." If you implement the iframe in
|
onproductselect
를 수신 대기하는 방법을 보여줍니다.
iframe.register('onproductselect', function(event) { console.log(event); }, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);