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. i uzyskiwanie dodatkowych informacji.

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. W menu użytkownicy mogą przechodzić na różne strony:

  • Wyszukiwanie aplikacji: umożliwia administratorom IT wyszukiwanie i przeglądanie Google. Google Play, wyświetlanie szczegółów i wybieranie aplikacji.
  • Aplikacje prywatne: umożliwia administratorom IT publikowanie prywatnych aplikacji i zarządzanie nimi. dla firm.
  • Aplikacje internetowe: umożliwia administratorom IT publikowanie i rozpowszechnianie witryn skróty jako aplikacje.
  • Porządkowanie aplikacji: pozwala administratorom IT konfigurować działanie aplikacji. uporządkowane w aplikacji Sklep Play na urządzeniach użytkowników.

Wszystkie strony są domyślnie 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 implementowaniu tych funkcji znajdziesz w artykule Dodaj element iframe do konsoli.

Dodawanie elementu iframe do konsoli

Krok 1. Generowanie tokena internetowego

Aby wygenerować token sieciowy identyfikujący firmę, wywołaj Enterprises.createWebToken Przykład poniżej pokazuje, jak pobrać token za pomocą usług EMM w Google Play. Biblioteka klienta API do języka Java

Wszystkie strony w elemencie iframe są domyślnie włączone. Przy generowaniu tokena sieciowego może określać strony, które mają zostać wyłączone. Przykład poniżej wyłącza 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();
}

Zwrócony token musisz podać razem z innymi parametrami, i renderowanie elementu iframe w konsoli.

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óry ma być stosowany do tagu iframe, można ustawić za pomocą atrybutu jako powyżej.

Parametry adresu URL

Tabela poniżej zawiera 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 (porządkuj aplikacje). Jeśli nie określono tej kolejności, będzie to: pierwszeństwo określa, która strona zostanie wyświetlona: 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óra służy do lokalizowania treści w elemencie iframe. Jeśli go nie podasz, wartość domyślna to 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 poziomu elementu iframe.
FALSE: nie jest wyświetlane pole wyszukiwania.
search Szukaj aplikacji Nie Ciąg znaków wyszukiwania. Jeśli element iframe zostanie określony, kieruje administratora IT do wyników wyszukiwania z użyciem parametru określonego ciągu.

Krok 3. Obsługa zdarzeń iframe

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

ZdarzenieOpis
onproductselect Użytkownik wybiera lub zatwierdza aplikację. Zwracany jest 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".
}
Poniższy przykład pokazuje, jak słuchać utworu onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);