관리 Google Play iframe

관리 Google Play iframe을 사용하여 관리 Google Play를 삽입할 수 있습니다. 직접 관리할 수 있어 고객에게 통합 모바일 관리 기능을 제공할 수 있습니다. 경험해 볼 수 있습니다

<ph type="x-smartling-placeholder">
</ph> 관리 Google Play iframe
그림 1. 관리 Google Play iframe 검색 앱 페이지를 표시합니다.

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 SELECT
    mode, the only possible value is "selected".
}
아래 샘플은 onproductselect를 수신 대기하는 방법을 보여줍니다. 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);