Enterprises: pullNotificationSet

Pobiera i zwraca powiadomienie ustawione dla firm powiązanych z konto usługi uwierzytelnione dla tego żądania. Ustawione powiadomienia mogą jest puste, jeśli nie ma żadnych oczekujących powiadomień.
Zwrócony zestaw powiadomień musi zostać potwierdzony w ciągu 20 sekund przez wywołanie Enterprises.Acknowledge NotificationSet, chyba że zestaw powiadomień jest pusty.
Powiadomienia, które nie zostaną potwierdzone w ciągu 20 sekund, zostaną ponownie uwzględnione w odpowiedzi na kolejną prośbę o wyświetlenie zestawu powiadomień, a te, które nigdy nie zostaną potwierdzone, zostaną ostatecznie usunięte zgodnie z zasadami systemu Pub/Sub na platformie Google Cloud Platform.
W celu pobrania można wykonywać wiele żądań jednocześnie. Powiadomienia, które to oznacza, że oczekujące powiadomienia (jeśli są) zostaną podzieloną między każdego wywołującego, jeśli istnieją jakieś oczekujące.
W przypadku braku powiadomień zwracana jest pusta lista powiadomień. Kolejne żądania mogą zwracać więcej powiadomień, gdy tylko się pojawią. i dostępności informacji.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

Parametry

Nazwa parametru Wartość Opis
Parametry opcjonalne zapytania
requestMode string Tryb żądania pobierania powiadomień.
Jeśli określisz wartość waitForNotifications, żądanie zostanie zablokowane i czekać będzie na pojawienie się co najmniej jednego powiadomienia. Jeśli po pewnym czasie nie pojawi się żadne powiadomienie, zwrócona zostanie pusta lista powiadomień.
Określenie returnImmediately spowoduje, że żądanie natychmiast zwróci oczekujące powiadomienia lub pustą listę, jeśli nie powiadomienia.
W przypadku pominięcia tej opcji domyślnie ustawiana jest wartość waitForNotifications.

Akceptowane wartości:
  • „returnImmediately”
  • „waitForNotifications”

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

Zakres
https://www.googleapis.com/auth/androidenterprise

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

Nie podawaj treści żądania przy użyciu tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

{
  "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 jako odebranego za pomocą interfejsu Enterprises.Acknowledge Notification API. W przypadku braku powiadomień ta informacja zostanie pominięta.
notification[] list Otrzymane powiadomienia lub puste pole, jeśli nie ma żadnych powiadomień.
notification[].enterpriseId string Identyfikator firmy, dla której zostało wysłane powiadomienie. Ten adres będzie zawsze widoczny.
notification[].timestampMillis long Czas opublikowania powiadomienia w milisekundach od 1970-01-01T00:00:00Z. Ten adres będzie 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 się zmienił. To pole będzie zawsze obecne.
notification[].productApprovalEvent.approved string Informacja, czy produkt był zatwierdzony czy niezatwierdzony. To pole będzie zawsze obecne.

Akceptowane wartości:
  • „approved”
  • „unapproved”
  • „unknown”
notification[].installFailureEvent nested object Powiadomienia o niepowodzeniu instalacji aplikacji.
notification[].installFailureEvent.productId string Identyfikator produktu (np. „app:com.google.android.gm”), w przypadku którego wystąpiło zdarzenie niepowodzenia instalacji. To pole będzie zawsze obecne.
notification[].installFailureEvent.deviceId string Identyfikator Androida urządzenia. To pole będzie zawsze obecne.
notification[].installFailureEvent.userId string Identyfikator użytkownika. To pole będzie zawsze widoczne.
notification[].installFailureEvent.failureReason string Powód niepowodzenia instalacji. To pole będzie zawsze obecne.

Akceptowane wartości to:
  • „timeout”
  • „unknown”
notification[].installFailureEvent.failureDetails string Dodatkowe informacje o błędzie (w stosownych przypadkach).
notification[].appUpdateEvent nested object Powiadomienia o aktualizacjach aplikacji.
notification[].appUpdateEvent.productId string Identyfikator zaktualizowanego produktu (np. „app:com.google.android.gm”). To pole będzie zawsze widoczne.
notification[].newPermissionsEvent nested object Powiadomienia o nowych uprawnieniach aplikacji.
notification[].newPermissionsEvent.productId string Identyfikator produktu (np. „app:com.google.android.gm”), dla którego dodano nowe uprawnienia. To pole będzie zawsze widoczne.
notification[].newPermissionsEvent.requestedPermissions[] list Zestaw uprawnień, o które obecnie prosi aplikacja. Użyj interfejsu API EMM, aby uzyskać szczegółowe informacje o tych uprawnieniach.
notification[].newPermissionsEvent.approvedPermissions[] list Zestaw uprawnień, które administrator firmy już zatwierdził dla tej aplikacji. Aby pobrać szczegółowe informacje o tych uprawnieniach, użyj interfejsu Permissions.Pobierz z interfejsu EMM API.
notification[].appRestrictionsSchemaChangeEvent nested object Powiadomienia o zmianach schematu 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 będzie zawsze obecne.
notification[].productAvailabilityChangeEvent nested object powiadomienia o zmianach dostępności produktów;
notification[].productAvailabilityChangeEvent.productId string Identyfikator produktu (np. „app:com.google.android.gm”), którego dostępność uległa zmianie. To pole będzie zawsze obecne.
notification[].productAvailabilityChangeEvent.availabilityStatus string Nowy stan produktu. To pole będzie zawsze obecne.

Akceptowane wartości to:
  • „available”
  • „removed”
  • „unknown”
  • „unpublished”
notification[].newDeviceEvent nested object Powiadomienia o nowych urządzeniach.
notification[].newDeviceEvent.userId string Identyfikator użytkownika. To pole będzie zawsze obecne.
notification[].newDeviceEvent.deviceId string Identyfikator Androida urządzenia. To pole będzie zawsze obecne.
notification[].newDeviceEvent.managementType string Określa, w jak dużym stopniu urządzenie jest kontrolowane przez EMM Androida w różnych konfiguracjach wdrożenia.

Możliwe wartości:
  • „managedDevice”, czyli urządzenie, na którym DPC jest ustawionym jako właściciel urządzenia;
  • „managedProfile” – urządzenie, na którym DPC jest ustawionym jako właściciel profilu.


Akceptowane wartości:
  • „managedDevice”
  • „managedProfile”
notification[].notificationType string Typ powiadomienia.

Akceptowane wartości to:
  • „appRestricionsSchemaChange”
  • „appUpdate”
  • „deviceReportUpdate”
  • „installFailure”
  • „newDevice”
  • „newPermissions”
  • „productApproval”
  • „productAvailabilityChange”
  • „testNotification”
  • „unknown”
notification[].newDeviceEvent.dpcPackageName string Zasady na urządzeniu.
notification[].deviceReportUpdateEvent nested object Powiadomienia o aktualizacjach raportów o urządzeniach.
notification[].deviceReportUpdateEvent.userId string Identyfikator użytkownika. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.deviceId string Identyfikator Androida urządzenia. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report nested object Raport o urządzeniach został zaktualizowany o najnowsze stany aplikacji. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Sygnatura czasowa ostatniej aktualizacji raportu wyrażona w milisekundach od początku epoki. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.appState[] list Lista stanów aplikacji ustawionych przez aplikacje zarządzane na urządzeniu. Stany aplikacji są definiowane przez deweloperów aplikacji. To pole będzie zawsze widoczne.
notification[].deviceReportUpdateEvent.report.appState[].packageName string Nazwa pakietu aplikacji. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Lista stanów aplikacji z kluczem. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Klucz wskazujący, do czego aplikacja dostarcza stan. Zawartość klucza jest określana przez dewelopera aplikacji. Aby zapobiec atakom XSS, zalecamy usunięcie z klucza kodu HTML przed jego wyświetleniem. To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Sygnatura czasowa momentu, w którym aplikacja ustawiła stan (w milisekundach od początku epoki). To pole będzie zawsze obecne.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Waga stanu aplikacji. To pole będzie zawsze obecne.

Akceptowane wartości to:
  • „severityError”
  • „severityInfo”
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Swobodny, zrozumiały dla człowieka komunikat opisujący stan aplikacji. Może to być na przykład komunikat o błędzie. Aby zapobiec atakom XSS, zalecamy usunięcie kodu HTML z wiadomości przed jej wyświetleniem.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Dodatkowe pole przeznaczone na dane czytelne dla komputera. Na przykład liczba lub obiekt JSON. Aby zapobiec atakom XSS, zalecamy usunięcie z danych kodu HTML przed jego wyświetleniem.
kind string