Element iframe zarządzanego Sklepu Google Play

Dzięki elementowi iframe zarządzanego Sklepu Google Play możesz osadzić zarządzany Sklep Google Play bezpośrednio w konsoli EMM, aby zapewnić klientom spójne zarządzanie urządzeniami mobilnymi.

Element iframe zarządzanego Sklepu Google Play
Rysunek 1. Element iframe zarządzanego Sklepu Google Play wyświetlający stronę wyszukiwania aplikacji

iframe zawiera pasek tytułu i rozwijane menu boczne. W menu użytkownicy mogą przechodzić do różnych stron:

  • Wyszukiwanie aplikacji: umożliwia administratorom IT wyszukiwanie i przeglądanie aplikacji w Google Play, wyświetlanie szczegółów aplikacji oraz ich wybieranie.
  • Aplikacje prywatne: umożliwiają administratorom IT publikowanie aplikacji prywatnych i zarządzanie nimi w firmie.
  • Aplikacje internetowe: umożliwiają administratorom IT publikowanie i rozpowszechnianie skrótów do witryn jako aplikacji.
  • Porządkowanie aplikacji: umożliwia administratorom IT konfigurowanie sposobu porządkowania aplikacji w aplikacji Sklep Play na urządzeniach użytkowników.

Domyślnie wszystkie strony są włączone w elemecie iframe, ale można je wyłączyć pojedynczo (patrz Dodawanie elementu iframe do konsoli).

Funkcje

W tej sekcji opisaliśmy funkcje dostępne w elementach iframe zarządzanego Sklepu Google Play. Informacje o tym, jak osadzić element iframe i wdrożyć te funkcje, znajdziesz w artykule Dodawanie elementu iframe do konsoli.

Dodawanie elementu iframe do konsoli

Krok 1. Generowanie tokena internetowego

Aby wygenerować token internetowy, który identyfikuje firmę, wywołaj funkcję Enterprises.createWebToken. Ten przykład pokazuje, jak pobrać token za pomocą biblioteki klienta interfejsu EMM Google Play API w Javie.

Domyślnie wszystkie strony w ramce iframe są włączone. Podczas generowania tokenu internetowego możesz określić, które strony mają być wyłączone. W tym przykładzie wyłączono opcje Aplikacje prywatne, Aplikacje internetowe i Uporządkuj aplikacje.

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();
}

Podczas renderowania ramki iframe w konsoli musisz uwzględnić zwrócony token wraz z innymi parametrami.

Krok 2. Renderowanie elementu iframe

Oto przykład renderowania zarządzanego elementu iframe Sklepu Play:

<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>

Ten kod generuje element iframe w kontenerze div. Atrybuty, które mają być stosowane do tagu iframe, można ustawić za pomocą opcji „Atrybuty”, jak opisano powyżej.

Parametry adresu URL

Tabela poniżej zawiera wszystkie parametry iframe, które można dodać do adresu URL jako parametry adresu URL, np.:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
Parametr Strona Wymagane Opis
token Nie dotyczy Tak Token zwrócony w kroku 1.
iframehomepage Nie dotyczy Nie Początkowa strona wyświetlana po wyrenderowaniu elementu iframe. Możliwe wartości to PLAY_SEARCH, WEB_APPS, PRIVATE_APPS i STORE_BUILDER (organizowanie aplikacji). Jeśli nie określisz tu żadnej strony, kolejność wyświetlania będzie następująca: PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale Nie dotyczy Nie poprawnie sformułowany tag języka BCP 47, który służy do lokalizacji treści w ramce iframe; Jeśli nie podasz żadnej opcji, domyślna wartość to en_US.
mode Szukaj aplikacji Nie SELECT: pozwala administratorom IT wybierać aplikacje.
APPROVE (domyślnie): pozwala administratorom IT wybierać, zatwierdzać i odwoływać zatwierdzenia aplikacji.
showsearchbox Szukaj aplikacji Nie TRUE (domyślnie): wyświetla pole wyszukiwania i inicjuje zapytanie wyszukiwania z poziomu elementu iframe.
FALSE: nie wyświetla się pole wyszukiwania.
search Szukaj aplikacji Nie Ciąg wyszukiwania. Jeśli jest określony, iframe kieruje administratora IT do wyników wyszukiwania z wybraną przez niego sekwencją znaków.

Krok 3. Obsługa zdarzeń iframe

W ramach integracji musisz też obsługiwać te zdarzenia.

ZdarzenieOpis
onproductselect Użytkownik wybiera lub zatwierdza aplikację. Zwraca obiekt zawierający:
{
    "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".
}
Przykład poniżej pokazuje, jak nasłuchiwać zdarzeń onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);