Element iframe zarządzanego Sklepu Google Play

Dzięki elementowi iframe zarządzanego Sklepu Google Play możesz umieścić zarządzany Sklep Google Play bezpośrednio w konsoli EMM, by zapewnić klientom ujednolicone zarządzanie urządzeniami mobilnymi.

Element iframe zarządzanego Sklepu Google Play
Rysunek 1. Element iframe zarządzanego Sklepu Google Play ze stroną wyszukiwania aplikacji.

Element iframe zawiera pasek tytułu i rozwijane menu boczne. Za pomocą tego 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 ich szczegółów i wybieranie aplikacji.
  • Aplikacje prywatne: umożliwia administratorom IT publikowanie aplikacji prywatnych dla firmy i zarządzanie nimi.
  • Aplikacje internetowe: umożliwia administratorom IT publikowanie i rozpowszechnianie skrótów do witryn jako aplikacji.
  • Porządkowanie aplikacji: pozwala administratorom IT konfigurować sposób porządkowania aplikacji w aplikacji Sklep Play na urządzeniach użytkowników.

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

Funkcje

W tej sekcji opisujemy funkcje dostępne w elemencie iframe zarządzanego Sklepu Google Play. Informacje na temat umieszczania elementu iframe i wdrażania tych funkcji znajdziesz w artykule Dodawanie elementu iframe do konsoli.

Dodawanie elementu iframe do konsoli

Krok 1. Generowanie tokena internetowego

Aby wygenerować token internetowy identyfikujący firmę, wywołaj Enterprises.createWebToken. Poniższy przykład pokazuje, jak pobrać token przy użyciu biblioteki klienta interfejsu Google Play EMM API dla języka Java.

Wszystkie strony w elemencie iframe są domyślnie włączone. Przy generowaniu tokena internetowego możesz określić strony, które chcesz wyłączyć. W poniższym przykładzie wyłączono aplikacje prywatne, aplikacje internetowe i porzą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 elementu iframe w konsoli musisz uwzględnić zwrócony token wraz z innymi parametrami.

Krok 2. Renderowanie elementu iframe

Oto przykład renderowania elementu iframe zarządzanego 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 wewnątrz kontenera div. Atrybuty, które mają być stosowane do tagu iframe, można ustawić za pomocą opcji „attributes”, jak pokazano powyżej.

Parametry adresu URL

W tabeli poniżej znajdziesz wszystkie dostępne parametry elementu 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 z kroku 1.
iframehomepage Nie dotyczy Nie Strona początkowa wyświetlana po renderowaniu elementu iframe. Możliwe wartości to PLAY_SEARCH, WEB_APPS, PRIVATE_APPS i STORE_BUILDER (uporządkowanie aplikacji). Jeśli nie podasz tu żadnej wartości, zostanie ona wyświetlona zgodnie z następującą kolejnością: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale Nie dotyczy Nie Prawidłowo sformatowany tag języka BCP 47, który służy do lokalizowania treści w elemencie iframe. Jeśli nie podasz żadnej wartości, domyślną wartością będzie en_US.
mode Szukaj aplikacji Nie SELECT: pozwala administratorom IT wybierać aplikacje.
APPROVE (domyślnie): pozwala administratorom IT wybierać, zatwierdzać i unieważniać aplikacje.
showsearchbox Szukaj aplikacji Nie TRUE (domyślnie): wyświetla pole wyszukiwania i inicjuje zapytanie z elementu iframe.
FALSE: nie jest wyświetlane pole wyszukiwania.
search Szukaj aplikacji Nie Ciąg znaków wyszukiwania. Jeśli element iframe jest określony, kieruje administratora IT do wyników wyszukiwania z określonym ciągiem znaków.

Krok 3. Obsługa zdarzeń iframe

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

ZdarzenieOpis
onproductselect Użytkownik wybiera lub zatwierdza aplikację. Spowoduje to zwrócenie obiektu zawierającego:
{
    "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".
}
Poniższy przykład pokazuje, jak słuchać onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);