Enterprises: pullNotificationSet

Extrai e retorna um conjunto de notificações para as empresas associadas à conta de serviço autenticada para a solicitação. O conjunto de notificações pode vazio se nenhuma notificação estiver pendente.
Um conjunto de notificações retornado precisa ser confirmado em 20 segundos chamando Enterprises.AcceptNotificationSet, a menos que o o conjunto de notificações está vazio.
As notificações que não forem confirmadas dentro de 20 segundos serão ser incluído novamente na resposta a outro objeto PullNotificationSet solicitação, e aqueles que nunca forem confirmados serão excluídos de acordo com a política do sistema do Pub/Sub do Google Cloud Platform.
Várias solicitações podem ser realizadas simultaneamente para recuperar notificações. Nesse caso, as notificações pendentes (se houver) serão divididos entre cada autor da chamada, se houver algum pendente.
Se nenhuma notificação estiver presente, uma lista de notificações vazia será retornada. As solicitações subsequentes podem retornar mais notificações quando se tornarem disponíveis.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de consulta opcionais
requestMode string O modo de solicitação para puxar notificações.
A especificação de waitForNotifications faz com que a solicitação seja bloqueada e aguarde até que uma ou mais notificações estejam presentes ou retorne uma lista de notificações vazia se nenhuma notificação estiver presente após algum tempo.
A especificação de returnImmediately fará com que a solicitação retorne imediatamente as notificações pendentes ou uma lista vazia se nenhuma notificação estiver presente.
Se omitido, o padrão é waitForNotifications.

Os valores aceitáveis são os seguintes:
  • "returnImmediately"
  • "waitForNotifications"

Autorização

Esta solicitação requer autorização com o seguinte escopo:

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

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Nome da propriedade Valor Descrição Observações
notificationSetId string O ID do conjunto de notificações, necessário para marcar a notificação como recebida com a API Enterprises.RecognitionNotification. Essa informação será omitida se não houver notificações.
notification[] list As notificações recebidas ou vazia se não houver notificações.
notification[].enterpriseId string O ID da empresa para que a notificação é enviada. Ele sempre estará presente.
notification[].timestampMillis long A hora em que a notificação foi publicada em milissegundos desde 1970-01-01T00:00:00Z. Ele sempre estará presente.
notification[].productApprovalEvent nested object Notificações sobre mudanças no status de aprovação de um produto.
notification[].productApprovalEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") cujo status de aprovação foi alterado. Este campo sempre estará presente.
notification[].productApprovalEvent.approved string Se o produto foi aprovado ou não. Esse campo sempre estará presente.

Os valores aceitáveis são:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Notificações sobre uma falha na instalação do app.
notification[].installFailureEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") em que ocorreu o evento de falha de instalação. Este campo sempre estará presente.
notification[].installFailureEvent.deviceId string O ID do Android do dispositivo. Este campo sempre estará presente.
notification[].installFailureEvent.userId string O ID do usuário. Esse campo sempre estará presente.
notification[].installFailureEvent.failureReason string O motivo da falha na instalação. Este campo sempre estará presente.

Os valores aceitáveis são:
  • "timeout"
  • "unknown"
notification[].installFailureEvent.failureDetails string Mais detalhes sobre a falha, se aplicável.
notification[].appUpdateEvent nested object Notificações sobre atualizações de apps.
notification[].appUpdateEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") que foi atualizado. Este campo sempre estará presente.
notification[].newPermissionsEvent nested object Notificações sobre novas permissões de apps.
notification[].newPermissionsEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") ao qual novas permissões foram adicionadas. Esse campo sempre estará presente.
notification[].newPermissionsEvent.requestedPermissions[] list O conjunto de permissões que o app está solicitando no momento. Use Permissions.Acesse na API EMM para recuperar detalhes sobre essas permissões.
notification[].newPermissionsEvent.approvedPermissions[] list O conjunto de permissões que o administrador da empresa já aprovou para este aplicativo. Use Permissions.Acesse na API EMM para recuperar detalhes sobre essas permissões.
notification[].appRestrictionsSchemaChangeEvent nested object Notificações sobre novas mudanças no esquema de restrições de apps.
notification[].appRestrictionsSchemaChangeEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") para o qual o esquema de restrição do app foi alterado. Este campo sempre estará presente.
notification[].productAvailabilityChangeEvent nested object Notificações sobre mudanças na disponibilidade do produto.
notification[].productAvailabilityChangeEvent.productId string O ID do produto (por exemplo, "app:com.google.android.gm") para o qual a disponibilidade do produto foi alterada. Este campo sempre estará presente.
notification[].productAvailabilityChangeEvent.availabilityStatus string O novo estado do produto. Este campo sempre estará presente.

Os valores aceitáveis são:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
notification[].newDeviceEvent nested object Notificações sobre novos dispositivos.
notification[].newDeviceEvent.userId string O ID do usuário. Este campo sempre estará presente.
notification[].newDeviceEvent.deviceId string O ID do Android do dispositivo. Este campo sempre estará presente.
notification[].newDeviceEvent.managementType string Identifica o nível em que o dispositivo é controlado por um EMM do Android em várias configurações de implantação.

Os valores possíveis incluem:
  • "managedDevice", um dispositivo em que o DPC está definido como proprietário do dispositivo,
  • "managedProfile", um dispositivo em que o DPC está definido como proprietário do perfil.


Os valores aceitáveis são:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string Tipo da notificação.

Os valores aceitáveis são:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
notification[].newDeviceEvent.dpcPackageName string app Policy no dispositivo.
notification[].deviceReportUpdateEvent nested object Notificações sobre atualizações de relatórios do dispositivo.
notification[].deviceReportUpdateEvent.userId string O ID do usuário. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.deviceId string O ID do Android do dispositivo. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report nested object O relatório do dispositivo foi atualizado com os estados mais recentes do app. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long É o carimbo de data/hora da última atualização do relatório em milissegundos desde o período. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[] list Lista de estados definidos pelos apps gerenciados no dispositivo. Os estados do app são definidos pelos desenvolvedores. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[].packageName string O nome do pacote do app. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Lista de estados do app com chave. Esse campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Chave que indica para qual estado o app está fornecendo um estado. O conteúdo da chave é definido pelo desenvolvedor do app. Para evitar XSS, recomendamos remover qualquer HTML da chave antes de exibi-la. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Carimbo de data/hora de quando o app definiu o estado em milissegundos desde a época. Este campo sempre estará presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Gravidade do estado do app. Este campo sempre estará presente.

Os valores aceitáveis são:
  • "severityError"
  • "severityInfo"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Mensagem de formato livre legível por humanos que descreve o estado do app. Por exemplo, uma mensagem de erro. Para evitar XSS, recomendamos remover qualquer HTML da mensagem antes de exibi-la.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Campo adicional destinado a dados legíveis por máquina. Por exemplo, um número ou objeto JSON. Para evitar o XSS, recomendamos remover qualquer HTML dos dados antes de exibi-los.
kind string