관리 Google Play iframe을 사용하면 관리 Google Play를 EMM 콘솔에 직접 삽입하여 고객에게 통합된 모바일 관리 환경을 제공할 수 있습니다.
iframe에는 제목 표시줄과 확장 가능한 측면 메뉴가 포함되어 있습니다. 사용자는 메뉴에서 다음과 같은 다양한 페이지로 이동할 수 있습니다.
- 앱 검색: IT 관리자가 Google Play 앱을 검색 및 탐색하고, 앱 세부정보를 확인하고, 앱을 선택할 수 있습니다.
- 비공개 앱: IT 관리자가 기업을 위해 비공개 앱을 게시하고 관리할 수 있습니다.
- 웹 앱: IT 관리자가 웹사이트 바로가기를 앱으로 게시하고 배포할 수 있습니다.
- 앱 정리: IT 관리자가 사용자 기기의 Play 스토어 앱에서 앱이 구성되는 방식을 구성할 수 있습니다.
모든 페이지는 기본적으로 iframe에서 사용 설정되지만 개별적으로 사용 중지할 수 있습니다(콘솔에 iframe 추가 참고).
기능
이 섹션에서는 관리 Google Play iframe에서 사용할 수 있는 기능을 설명합니다. iframe을 삽입하고 이러한 기능을 구현하는 방법에 관한 자세한 내용은 Console에 iframe 추가를 참고하세요.
앱 검색
검색 앱 페이지 (그림 1 참고)를 사용하면 IT 관리자가 Google Play 앱을 검색, 둘러보고 선택할 수 있습니다.
검색창
페이지의 제목 표시줄에 있는 검색창은 기본적으로 사용 설정되어 있습니다. 검색창은 자동 완성과 같은 기능을 지원하며 Google Play에 공개적으로 등록된 앱의 결과를 반환합니다. 검색 결과가 iframe 내에 표시됩니다.
비공개 앱
비공개 앱 페이지를 사용하면 IT 관리자가 EMM 콘솔에서 직접 비공개 앱을 게시하고 관리할 수 있습니다. IT 관리자를 위한 비공개 앱 게시를 간소화하기 위해 이 페이지에서는 다음을 제공합니다.
- 기업을 대신하여 Play Console 계정을 자동으로 만들고 IT 관리자에게 관리 액세스 권한을 부여합니다.
- 이전에 앱을 게시하는 데 필요했던 Play Console 등록비용 미화 25달러가 면제됩니다.
- 앱의 APK와 제목만 있으면 됩니다.
- 앱을 10분 이내에 게시합니다 (Play Console의 2시간과 비교).
참고: 비공개 앱 페이지에서 게시된 앱은 공개할 수 없습니다.
IT 관리자가 iframe에 앱을 처음 게시하면 iframe에서 엔터프라이즈를 대신하여 Play Console 계정을 자동으로 만듭니다. 고급 수정을 수행하면 Google 계정 (Gmail, Cloud ID 등)으로 로그인하라는 메시지가 표시됩니다. 이 Google 계정이 기업의 Play Console 계정 관리자로 추가됩니다. 그런 다음 IT 관리자는 Google 계정을 사용하여 Play Console에 직접 로그인하여 다음 작업을 할 수 있습니다.
- 관리자 계정 추가 및 관리
- 설명, 스크린샷 등을 포함한 고급 앱 세부정보를 추가합니다.
- 앱 게시 취소
비공개 앱 페이지를 사용하는 방법에 관한 IT 관리자 안내는 관리 Google Play 고객센터에서 확인할 수 있습니다.
선택 버튼
앱이 게시된 후 IT 관리자는 앱 세부정보 페이지에서 제목과 APK를 수정할 수 있습니다. 앱 세부정보 페이지에는 SELECT 버튼도 표시됩니다 (그림 2 참고). IT 관리자가 이 버튼을 클릭할 때 실행할 작업을 지정해야 합니다 (3단계onproductselect iframe 이벤트 처리)
웹 앱
웹 앱 페이지를 사용하면 IT 관리자가 웹사이트 바로가기를 관리 Google Play에 비공개 앱으로 게시할 수 있습니다.
웹 앱은 패키지 이름 (productId)으로 식별할 수 있으며 일반적으로 게시하는 데 10분이 걸립니다. 게시 후 엔터프라이즈에서 자동으로 승인되며 다른 승인된 앱과 마찬가지로 사용자에게 배포할 수 있습니다. 웹 앱은 다른 관리 Play iframe 기능과 호환됩니다. Play 검색 페이지에서 검색할 수 있으며 컬렉션에 추가할 수 있습니다.
웹 앱 생성 양식에는 제목, HTTPS 또는 HTTP URL, 아이콘 이미지 (512x512 JPG 또는 32비트 PNG)가 필요합니다. 또한 IT 관리자는 다음 세 가지 표시 옵션 중에서 선택할 수 있습니다.
- 전체 화면: 앱이 전체 화면 모드로 열리고 기기의 상태 표시줄과 탐색 메뉴가 숨겨집니다.
- 독립형 (기본값): 앱에 기기의 상태 표시줄과 탐색 메뉴가 표시됩니다.
- 최소 UI: 앱에 기기의 상태 표시줄 및 탐색 메뉴, 앱의 URL, 새로고침 옵션이 표시됩니다. HTTP URL의 경우 이 옵션만 사용할 수 있습니다.
또한 웹 앱 페이지에서 IT 관리자는 웹 앱을 수정하고 삭제할 수 있습니다. 웹 앱을 삭제하면 사용자의 관리 Google Play 스토어에서 앱이 삭제되지만 앱이 이미 기기에 설치되어 있는 경우 사용자는 계속 액세스할 수 있습니다. 사용자의 기기에서 웹 앱을 삭제하려면 앱 삭제를 참고하세요. 웹 앱을 만들고 수정하는 방법에 관한 사용자 안내는 관리 Google Play 고객센터에서 확인할 수 있습니다.
선택 버튼
웹 앱이 게시되면 세부정보 페이지에 SELECT 버튼이 포함됩니다. IT 관리자가 이 버튼을 클릭할 때 실행할 작업 (예: 앱 배포)을 지정해야 합니다(3단계의 onproductselect 참고). iframe 이벤트 처리)
앱 정리
앱 정리 페이지를 사용하면 IT 관리자가 앱을 컬렉션 (클러스터라고도 함)으로 정리할 수 있습니다. 예를 들어 IT 관리자는 자주 사용하는 앱의 필수사항 컬렉션을 만들거나 비용 추적, 이동 기록 등과 관련된 앱의 비용 컬렉션을 만들 수 있습니다. 컬렉션은 사용자 기기의 Play 스토어 홈페이지에 표시됩니다.
EMM은 앱을 검색하고 컬렉션에 추가할 수 있도록 iframe URL의 매개변수에서
SELECT mode를 활용해야 합니다.
사용자 기기에서 Play 스토어 앱에는 사용자 (또는 기기)가 사용할 수 있는 컬렉션의 앱만 표시됩니다. 컬렉션에 사용자가 사용할 수 있는 앱 (또는 기기)이 포함되어 있지 않으면 컬렉션이 Play 스토어에 표시되지 않습니다.
IT 관리자는 앱 정리 페이지에서 기존 컬렉션을 수정, 삭제, 복사할 수도 있습니다. 이러한 작업을 실행하는 방법에 관한 사용자 안내는 관리 Google Play 고객센터에서 확인할 수 있습니다.
콘솔에 iframe 추가
1단계: 웹 토큰 생성
기업을 식별하는 웹 토큰을 생성하려면 Enterprises.createWebToken를 호출합니다.
다음 예는 자바용 Google Play EMM 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(); }
콘솔에서 iframe을 렌더링할 때 다른 매개변수와 함께 반환된 토큰을 포함해야 합니다.
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을 생성합니다. iframe 태그에 적용할 속성은 위와 같이 'attributes' 옵션으로 설정할 수 있습니다.
URL 매개변수
아래 표에는 URL에 URL 매개변수로 추가할 수 있는 iframe에 사용할 수 있는 모든 매개변수가 나와 있습니다. 예를 들면 다음과 같습니다.
'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 |
해당 사항 없음 | 아니요 | iframe의 콘텐츠를 현지화하는 데 사용되는 올바른 형식의 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);