Włącz powiadomienia push w usługach EMM

W tym przewodniku przyjęto założenie, że masz już ręcznie utworzoną umowę ESA. Pokazujemy jak skonfigurować ją pod kątem korzystania z powiadomień push usług EMM. Zadania zostały wykonane przez właściciela ESA (jako dostawcę rozwiązania EMM lub przez klienta) za pomocą Konsola interfejsów API Google:

1. Włącz dostęp do interfejsu Google Cloud Pub/Sub API w konsoli interfejsów API Google dla w chmurze.

2. Przyznaj ESA uprawnienia edytującego.

3. Skonfiguruj projekt, aby otrzymywać powiadomienia EMM.

4. Wyślij testowe powiadomienie EMM.

5. Zasubskrybowanie tematu.

Szczegółowe instrukcje znajdziesz w sekcjach poniżej.

1. Włączanie dostępu dla projektu przez interfejs Cloud Pub/Sub API

Aby aktywować interfejs Cloud Pub/Sub API w projekcie:

  1. W konsoli interfejsów API otwórz Bibliotekę interfejsów API. Wybierz projekt (lub utworzyć nowy, jeśli to konieczne). W bibliotece interfejsów API wymienione są wszystkie z dostępnymi interfejsami API pogrupowanymi według rodziny usług i popularności.
  2. W sekcji interfejsów API Google Cloud odszukaj interfejs Cloud Pub/Sub API. (Jeśli nie jest widoczna na liście, użyj funkcji wyszukiwania, aby ją znaleźć).
  3. Wybierz Cloud Pub/Sub API i kliknij Włącz.

Po włączeniu interfejsu API przejdź do sekcji Interfejsy API Kliknij menu „Usługi”. Panel, aby zobaczyć listę wszystkich włączonych interfejsów API. Zanim chmura Interfejsu Pub/Sub API może być używany na potrzeby wiadomości do klienta; musisz przyznać rolę Edytujący do konta usługi tego klienta (jego ESA).

2. Przyznaj ESA uprawnienia edytującego

W konsoli interfejsów API przyznaj niezbędne uprawnienia:

  1. Na stronie Interfejsy API w menu Usługi kliknij Dane logowania. Zalecenia zobaczyć listę ESA klienta w sekcji Klucze konta usługi.
  2. Kliknij Zarządzaj kontami usługi, aby otworzyć wszystkie konta usługi. powiązane z projektem.
  3. Wybierz z listy odpowiednie konto ESA i kliknij Uprawnienia:
  4. W polu Dodaj użytkowników:
    • Wpisz adres e-mail powiązany z ESA.
    • W menu wybierz Edytor (obok elementu ).
  5. Kliknij Dodaj, aby zapisać uprawnienia.

3. Konfigurowanie projektu do otrzymywania powiadomień EMM

Z włączonym Cloud Pub/Sub API i platformą ESA skonfigurowaną za pomocą edytora możesz skonfigurować projekt tak, aby otrzymywać powiadomienia EMM jako szczegóły w artykule Zestaw powiadomienia push usług EMM. Krótko mówiąc, proces konfiguracji obejmuje punkt końcowy serwera HTTP do wysyłania powiadomień subskrybentom.

Powiadomienia EMM są dostarczane jako protobufs (bufory protokołów, prosty format do serializacji danych uporządkowanych) spakowany jako wiadomości z tablicami bajtowymi zakodowane w formacie byte64 wewnątrz pakietów JSON. W swoim kodzie musisz przeanalizuj ten plik JSON i zdekoduj zawartość bufora protokołu. Oto przykład protokołu biblioteki NewPermissionsEvent zakodowanego w base64 zakodowanego w adresie URL powiadomienie:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

Dekoduje on:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

Aby zdekodować powiadomienia EMM w formacie protobuf, możesz użyć funkcji emm_pubsub.proto plik znajduje się w: google/play-work na GitHubie. Gdy nowe typy powiadomień są plik zostanie rozszerzony o nowy typ, a przykładowy kod zostanie zaktualizowany. Zmiany te powinny być zgodne wstecznie, ale upewnij się, że Twój kod jest na to odpowiedni z powiadomieniami o nieznanych typach który znajduje się w pliku .proto.

4. Wyślij testowe powiadomienie EMM

Wysłanie powiadomienia testowego pozwala potwierdzić, że udało Ci się skonfigurować system tak, aby otrzymywać powiadomienia EMM z Google Play; pozwala poznać nazwę tematu (ta sama nazwa jest używana do wszystkich powiadomień EMM z Google Play).

Wywołaj metodę sendTestPushNotification w zasobie Enterprises, używając interfejsu Play EMM API.

Wywoływanie tej operacji powoduje wysłanie testowego powiadomienia EMM. Jeśli usługi EMM są prawidłowo skonfigurowane, interfejs API zwraca następujące informacje:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

5. Subskrybowanie tematu

Przy użyciu przykładowego kodu dostępnego w sekcji Uruchamianie kod testowy wydawcy (w sekcji Konfiguracja powiadomień push z usługami EMM powiadomienia), zasubskrybuj określony temat. Otrzymasz testowe powiadomienie EMM, a także wszystkie prawdziwe powiadomienia, wygenerowane od momentu rozpoczęcia procesu konfiguracji.