Pobiera i zwraca powiadomienie wysyłane do firm powiązanych z kontem usługi uwierzytelnionym w żądaniu. Zestaw powiadomień może być pusty, jeśli nie ma oczekujących powiadomień.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund przez wywołanie klasy Enterprise.AcknowledgeNotificationSet, chyba że zbiór powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, zostaną ostatecznie uwzględnione w odpowiedzi na inne żądanie PullNotificationSet, a te, które nie zostaną potwierdzone, zostaną usunięte zgodnie z zasadami systemowymi Pub/Sub Google Cloud Platform.
Wiele żądań może być wysyłanych równolegle, aby umożliwić powiadomienie. W takim przypadku oczekujące powiadomienia (jeśli istnieją) są dzielone między poszczególnych rozmówców (jeśli istnieją).
Jeśli nie ma powiadomień, wyświetli się pusta lista powiadomień.
Kolejne żądania mogą zwracać więcej powiadomień, gdy staną się dostępne.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Opcjonalne parametry zapytania | ||
requestMode |
string |
Tryb wysyłania żądań powiadomień.
Podanie waitForNotifications spowoduje zablokowanie żądania i czekanie, aż pojawi się co najmniej 1 powiadomienie, lub zwracanie pustej listy, jeśli po pewnym czasie nie będzie żadnych powiadomień.
Jeśli określisz wartość returnImmediately , żądanie zostanie natychmiast zwrócone na oczekujące powiadomienia lub gdy lista będzie pusta, jeśli lista będzie pusta.
Jeśli nie zostanie podany, domyślną wartością jest waitForNotifications .
Akceptowane wartości:
|
Upoważnienie
To żądanie wymaga autoryzacji w następującym zakresie:
Zakres |
---|
https://www.googleapis.com/auth/androidenterprise |
Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.
Treść żądania
Nie udostępniaj treści żądania tą metodą.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:
{ "kind": "androidenterprise#notificationSet", "notificationSetId": string, "notification": [ { "enterpriseId": string, "timestampMillis": long, "notificationType": string, "productApprovalEvent": { "productId": string, "approved": string }, "installFailureEvent": { "productId": string, "deviceId": string, "userId": string, "failureReason": string, "failureDetails": string }, "appUpdateEvent": { "productId": string }, "newPermissionsEvent": { "productId": string, "requestedPermissions": [ string ], "approvedPermissions": [ string ] }, "appRestrictionsSchemaChangeEvent": { "productId": string }, "productAvailabilityChangeEvent": { "productId": string, "availabilityStatus": string }, "newDeviceEvent": { "userId": string, "deviceId": string, "managementType": string, "dpcPackageName": string }, "deviceReportUpdateEvent": { "userId": string, "deviceId": string, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] } } } ] }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
notificationSetId |
string |
Identyfikator zestawu powiadomień wymagany do oznaczenia powiadomienia za pomocą interfejsu Enterprises.AcknowledgeNotification API. Jeśli nie masz powiadomień, te dane zostaną pominięte. | |
notification[] |
list |
Powiadomienia zostały odebrane lub puste, jeśli nie ma żadnych powiadomień. | |
notification[].enterpriseId |
string |
Identyfikator firmy, której dotyczy powiadomienie. Będzie on zawsze widoczny. | |
notification[].timestampMillis |
long |
Czas opublikowania powiadomienia w milisekundach od 1970-01-01T00:00:00Z. Będzie on zawsze widoczny. | |
notification[].productApprovalEvent |
nested object |
Powiadomienia o zmianach stanu zatwierdzenia produktu. | |
notification[].productApprovalEvent.productId |
string |
Identyfikator produktu (np. „app:com.google.android.gm”), którego stan zatwierdzenia uległ zmianie. To pole zawsze będzie widoczne. | |
notification[].productApprovalEvent.approved |
string |
Informacja, czy produkt został zatwierdzony czy niezatwierdzony. To pole zawsze będzie widoczne.
Akceptowane wartości:
|
|
notification[].installFailureEvent |
nested object |
Powiadomienia o niepowodzeniu instalacji aplikacji. | |
notification[].installFailureEvent.productId |
string |
Identyfikator produktu (np. „app:com.google.android.gm”), dla którego wystąpił błąd instalacji. To pole zawsze będzie widoczne. | |
notification[].installFailureEvent.deviceId |
string |
Identyfikator Androida urządzenia. To pole zawsze będzie widoczne. | |
notification[].installFailureEvent.userId |
string |
Identyfikator użytkownika. To pole zawsze będzie widoczne. | |
notification[].installFailureEvent.failureReason |
string |
Przyczyna niepowodzenia instalacji. To pole zawsze będzie widoczne.
Akceptowane wartości:
|
|
notification[].installFailureEvent.failureDetails |
string |
Dodatkowe informacje o błędzie (w odpowiednich przypadkach). | |
notification[].appUpdateEvent |
nested object |
Powiadomienia o aktualizacjach aplikacji. | |
notification[].appUpdateEvent.productId |
string |
Identyfikator zaktualizowanego produktu (np. „app:com.google.android.gm”). To pole zawsze będzie widoczne. | |
notification[].newPermissionsEvent |
nested object |
Powiadomienia o nowych uprawnieniach aplikacji. | |
notification[].newPermissionsEvent.productId |
string |
Identyfikator usługi (np. „app:com.google.android.gm”), do której dodano nowe uprawnienia. To pole zawsze będzie widoczne. | |
notification[].newPermissionsEvent.requestedPermissions[] |
list |
Zbiór uprawnień, o które prosi obecnie aplikacja. Użyj Permissions.Pobierz w interfejsie EMM API, aby uzyskać szczegółowe informacje o tych uprawnieniach. | |
notification[].newPermissionsEvent.approvedPermissions[] |
list |
Zestaw uprawnień, które administrator firmy już zatwierdził dla tej aplikacji. Użyj Permissions.Pobierz w interfejsie EMM API, aby uzyskać szczegółowe informacje o tych uprawnieniach. | |
notification[].appRestrictionsSchemaChangeEvent |
nested object |
Powiadomienia o zmianach schematu zmian ograniczeń aplikacji. | |
notification[].appRestrictionsSchemaChangeEvent.productId |
string |
Identyfikator produktu (np. „app:com.google.android.gm”), w przypadku którego zmienił się schemat ograniczeń aplikacji. To pole zawsze będzie widoczne. | |
notification[].productAvailabilityChangeEvent |
nested object |
Powiadomienia o zmianach dostępności produktu. | |
notification[].productAvailabilityChangeEvent.productId |
string |
Identyfikator produktu (np. „app:com.google.android.gm”), w przypadku którego zmieniła się dostępność produktu. To pole zawsze będzie widoczne. | |
notification[].productAvailabilityChangeEvent.availabilityStatus |
string |
Nowy stan produktu. To pole zawsze będzie widoczne.
Akceptowane wartości:
|
|
notification[].newDeviceEvent |
nested object |
Powiadomienia o nowych urządzeniach. | |
notification[].newDeviceEvent.userId |
string |
Identyfikator użytkownika. To pole zawsze będzie widoczne. | |
notification[].newDeviceEvent.deviceId |
string |
Identyfikator Androida urządzenia. To pole zawsze będzie widoczne. | |
notification[].newDeviceEvent.managementType |
string |
Wskazuje, jak często urządzenie jest kontrolowane przez dostawcę usług EMM na urządzeniach z Androidem w różnych konfiguracjach wdrożenia. Możliwe wartości:
Akceptowane wartości to:
|
|
notification[].notificationType |
string |
Typ powiadomienia.
Akceptowane wartości:
|
|
notification[].newDeviceEvent.dpcPackageName |
string |
Aplikacja Zasady na urządzeniu. | |
notification[].deviceReportUpdateEvent |
nested object |
Powiadomienia o aktualizacjach raportów na temat urządzeń. | |
notification[].deviceReportUpdateEvent.userId |
string |
Identyfikator użytkownika. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.deviceId |
string |
Identyfikator Androida urządzenia. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report |
nested object |
Raport o urządzeniach zaktualizowany o najnowsze stany aplikacji. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis |
long |
Sygnatura czasowa ostatniej aktualizacji raportu w milisekundach od początku epoki. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[] |
list |
Lista stanów aplikacji ustawionych przez aplikacje zarządzane na urządzeniu. Stan aplikacji określa jej twórca. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[].packageName |
string |
Nazwa pakietu aplikacji. To pole będzie zawsze widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] |
list |
Lista stanów aplikacji z kluczami. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key |
string |
Klucz wskazujący cel działania aplikacji. Zawartość klucza jest ustawiana przez dewelopera aplikacji. Aby zapobiec XSS, zalecamy usunięcie z klucza dowolnego kodu HTML przed jego wyświetleniem. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis |
long |
Sygnatura czasowa wskazująca, kiedy aplikacja ustawiła stan w milisekundach od początku epoki. To pole zawsze będzie widoczne. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity |
string |
Poziom ważności aplikacji. To pole zawsze będzie widoczne.
Akceptowane wartości:
|
|
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message |
string |
Swobodny i czytelny komunikat opisujący stan aplikacji. Może to być na przykład komunikat o błędzie. Aby zapobiec XSS, zalecamy usunięcie z wiadomości dowolnego kodu HTML przed jej wyświetleniem. | |
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data |
string |
Dodatkowe pole przeznaczone dla danych w sposób czytelny dla komputerów. Może to być na przykład liczba lub obiekt JSON. Aby zapobiec wyświetlaniu XSS, zalecamy usunięcie z danych dowolnego kodu HTML. | |
kind |
string |