Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API. Więcej informacji

Ta strona została przetłumaczona przez Cloud Translation API.

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
`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`