Element iframe zarządzanego Sklepu Google Play

Za pomocą elementu iframe zarządzanego Sklepu Google Play możesz umieścić zarządzany Sklep Google Play bezpośrednio w konsoli EMM, aby zapewnić klientom ujednolicone zarządzanie urządzeniami mobilnymi.

element iframe zarządzanego Sklepu Google Play
Rysunek 1. Element iframe zarządzanego Sklepu Google Play przedstawiający stronę wyszukiwarki aplikacji.

Element iframe zawiera pasek tytułu i rozwijane menu boczne. Użytkownicy mogą przechodzić na różne strony z poziomu menu:

  • Wyszukiwanie aplikacji: pozwala administratorom IT wyszukiwać i przeglądać aplikacje z Google Play, wyświetlać ich szczegóły i wybierać aplikacje.
  • Aplikacje prywatne: umożliwia administratorom IT publikowanie aplikacji prywatnych na potrzeby firmy i zarządzanie nimi.
  • Aplikacje internetowe: umożliwia administratorom IT publikowanie i rozpowszechnianie skrótów do stron internetowych 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żna 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 o umieszczaniu elementu iframe i stosowaniu tych funkcji 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 Enterprises.createWebToken. Poniższy przykład pokazuje, jak pobrać token za pomocą biblioteki klienta interfejsu API interfejsu Google Play EMM dla Javy.

Wszystkie strony w elemencie iframe są domyślnie włączone. Podczas generowania tokena internetowego możesz określić, które strony chcesz wyłączyć. W przykładzie poniżej wyłączono aplikacje prywatne, aplikacje internetowe i porządkowanie aplikacji.

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 w kontenerze div. Atrybuty, które mają być stosowane do tagu iframe, można ustawić za pomocą opcji „Atrybuty”, jak przedstawialiśmy powyżej.

Parametry adresu URL

W tabeli poniżej znajdziesz wszystkie dostępne parametry elementu iframe, które możesz 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 podczas renderowania elementu iframe. Możliwe wartości to PLAY_SEARCH, WEB_APPS, PRIVATE_APPS i STORE_BUILDER (porządkuj aplikacje). Jeśli nie podasz żadnej wartości, będzie ona miała wpływ na to, która strona będzie wyświetlana: 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: umożliwia administratorom IT wybór aplikacji.
APPROVE (ustawienie domyślne): pozwala administratorom IT wybierać, zatwierdzać i cofać zatwierdzanie aplikacji. Ten tryb został wycofany. Użyj trybu SELECT. Tryb ZATWIERDZANIA działa tylko wtedy, gdy PlaySearch.ApproveApps ma wartość true w tokenie internetowym.
showsearchbox Szukaj aplikacji Nie TRUE (domyślnie): wyświetla pole wyszukiwania i inicjuje zapytanie z elementu iframe.
FALSE: pole wyszukiwania nie jest wyświetlane.
search Szukaj aplikacji Nie Ciąg tekstowy wyszukiwania. Jeśli element iframe zostanie określony, spowoduje to kierowanie 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 nasłuchiwać słowa onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);