Enterprises: pullNotificationSet

참고: 승인이 필요합니다.

요청에 대해 인증된 서비스 계정과 연결된 기업의 알림 세트를 가져와 반환합니다. 대기 중인 알림이 없으면 알림 세트가 비어 있을 수 있습니다.
반환된 알림 세트는 알림 세트가 비어 있지 않은 한 20초 이내에 Enterprises.AcknowledgeNotificationSet을 호출하여 확인해야 합니다.
20초 이내에 확인되지 않은 알림은 결국 다른 PullNotificationSet 요청에 대한 응답에 다시 포함되며, 확인되지 않은 알림은 결국 Google Cloud Platform Pub/Sub 시스템 정책에 따라 삭제됩니다.
알림을 검색하기 위해 여러 요청이 동시에 실행될 수 있습니다. 이 경우 대기 중인 알림이 있는 경우 각 호출자 간에 분할됩니다 (대기 중인 알림이 있는 경우).
알림이 없으면 빈 알림 목록이 반환됩니다. 후속 요청은 알림이 제공되면 더 많은 알림을 반환할 수 있습니다.

요청

HTTP 요청

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

매개변수

매개변수 이름	값	설명
선택적 쿼리 매개변수
requestMode	string	알림을 가져오기 위한 요청 모드입니다. waitForNotifications를 지정하면 요청이 차단되고 하나 이상의 알림이 있을 때까지 기다리거나 시간이 지나도 알림이 없으면 빈 알림 목록을 반환합니다. returnImmediately를 지정하면 요청이 대기 중인 알림을 즉시 반환하거나 알림이 없는 경우 빈 목록을 반환합니다. 생략하면 기본값은 waitForNotifications입니다. 허용되는 값은 다음과 같습니다. "returnImmediately" "waitForNotifications"

승인

다음 범위를 사용하여 이 요청을 인증받아야 합니다.

범위
https://www.googleapis.com/auth/androidenterprise

자세한 내용은 인증 및 승인 페이지를 참고하세요.

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "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
                }
              ]
            }
          ]
        }
      },
      "enterpriseUpgradeEvent": {
        "upgradeState": string
      }
    }
  ]
}

속성 이름	값	설명	참고
notificationSetId	string	Enterprises.AcknowledgeNotification API로 알림을 수신됨으로 표시하는 데 필요한 알림 세트 ID입니다. 알림이 없으면 생략됩니다.
notification[]	list	수신된 알림 또는 알림이 없는 경우 비어 있습니다.
notification[].enterpriseId	string	알림이 전송되는 기업의 ID입니다. 이 필드는 항상 표시됩니다.
notification[].timestampMillis	long	1970-01-01T00:00:00Z 이후 알림이 게시된 시간(밀리초)입니다. 이 필드는 항상 표시됩니다.
notification[].productApprovalEvent	nested object	제품의 승인 상태 변경에 관한 알림
notification[].productApprovalEvent.productId	string	승인 상태가 변경된 제품의 ID (예: 'app:com.google.android.gm')입니다. 이 필드는 항상 표시됩니다.
notification[].productApprovalEvent.approved	string	제품이 승인되었는지 여부입니다. 이 필드는 항상 표시됩니다. 허용되는 값은 다음과 같습니다. "approved" "unapproved" "unknown"
notification[].installFailureEvent	nested object	앱 설치 실패에 관한 알림
notification[].installFailureEvent.productId	string	설치 실패 이벤트가 발생한 제품의 ID입니다 (예: 'app:com.google.android.gm'). 이 필드는 항상 표시됩니다.
notification[].installFailureEvent.deviceId	string	기기의 Android ID입니다. 이 필드는 항상 표시됩니다.
notification[].installFailureEvent.userId	string	사용자의 ID입니다. 이 필드는 항상 표시됩니다.
notification[].installFailureEvent.failureReason	string	설치 실패 이유입니다. 이 필드는 항상 표시됩니다. 허용되는 값은 다음과 같습니다. "timeout" "unknown"
notification[].installFailureEvent.failureDetails	string	해당하는 경우 실패에 관한 추가 세부정보입니다.
notification[].appUpdateEvent	nested object	앱 업데이트에 관한 알림
notification[].appUpdateEvent.productId	string	업데이트된 제품의 ID입니다 (예: 'app:com.google.android.gm'). 이 필드는 항상 표시됩니다.
notification[].newPermissionsEvent	nested object	새 앱 권한에 관한 알림
notification[].newPermissionsEvent.productId	string	새 권한이 추가된 제품의 ID (예: 'app:com.google.android.gm')입니다. 이 필드는 항상 표시됩니다.
notification[].newPermissionsEvent.requestedPermissions[]	list	앱에서 현재 요청하고 있는 권한 집합입니다. EMM API에서 Permissions.Get을 사용하여 이러한 권한에 관한 세부정보를 가져옵니다.
notification[].newPermissionsEvent.approvedPermissions[]	list	엔터프라이즈 관리자가 이 애플리케이션에 대해 이미 승인한 권한 집합입니다. EMM API에서 Permissions.Get을 사용하여 이러한 권한에 관한 세부정보를 가져옵니다.
notification[].appRestrictionsSchemaChangeEvent	nested object	새로운 앱 제한 스키마 변경사항에 관한 알림
notification[].appRestrictionsSchemaChangeEvent.productId	string	앱 제한 스키마가 변경된 제품의 ID입니다 (예: 'app:com.google.android.gm'). 이 필드는 항상 표시됩니다.
notification[].productAvailabilityChangeEvent	nested object	제품 재고 변경 알림
notification[].productAvailabilityChangeEvent.productId	string	제품 재고 상태가 변경된 제품의 ID (예: 'app:com.google.android.gm')입니다. 이 필드는 항상 표시됩니다.
notification[].productAvailabilityChangeEvent.availabilityStatus	string	제품의 새 상태입니다. 이 필드는 항상 표시됩니다. 허용되는 값은 다음과 같습니다. "available" "removed" "unknown" "unpublished"
notification[].newDeviceEvent	nested object	새 기기에 관한 알림
notification[].newDeviceEvent.userId	string	사용자의 ID입니다. 이 필드는 항상 표시됩니다.
notification[].newDeviceEvent.deviceId	string	기기의 Android ID입니다. 이 필드는 항상 표시됩니다.
notification[].newDeviceEvent.managementType	string	다양한 배포 구성에서 Android EMM이 기기를 제어하는 정도를 식별합니다. 가능한 값은 다음과 같습니다. 'managedDevice': DPC가 기기 소유자로 설정된 기기 DPC가 프로필 소유자로 설정된 기기인 'managedProfile' 허용되는 값은 다음과 같습니다. "managedDevice" "managedProfile"
notification[].notificationType	string	알림 유형입니다. 허용되는 값은 다음과 같습니다. "appRestricionsSchemaChange" "appUpdate" "deviceReportUpdate" "enterpriseUpgrade" "installFailure" "newDevice" "newPermissions" "productApproval" "productAvailabilityChange" "testNotification" "unknown"
notification[].newDeviceEvent.dpcPackageName	string	기기의 정책 앱
notification[].deviceReportUpdateEvent	nested object	기기 보고서 업데이트에 관한 알림
notification[].deviceReportUpdateEvent.userId	string	사용자의 ID입니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.deviceId	string	기기의 Android ID입니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report	nested object	최신 앱 상태로 업데이트된 기기 보고서 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis	long	에포크 이후 마지막 보고서 업데이트의 타임스탬프(밀리초)입니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.appState[]	list	기기의 관리 앱에서 설정한 앱 상태 목록입니다. 앱 상태는 앱 개발자가 정의합니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.appState[].packageName	string	앱의 패키지 이름입니다. 이 필드는 항상 존재합니다.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]	list	키가 지정된 앱 상태 목록입니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key	string	앱이 상태를 제공하는 항목을 나타내는 키입니다. 키의 콘텐츠는 앱 개발자가 설정합니다. XSS를 방지하려면 키를 표시하기 전에 키에서 HTML을 모두 삭제하는 것이 좋습니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis	long	앱이 상태를 설정한 타임스탬프(에포크 이후 밀리초)입니다. 이 필드는 항상 표시됩니다.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity	string	앱 상태의 심각도입니다. 이 필드는 항상 표시됩니다. 허용되는 값은 다음과 같습니다. "severityError" "severityInfo"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message	string	앱 상태를 설명하는 인간이 읽을 수 있는 자유 형식 메시지입니다. 예를 들어 오류 메시지 XSS를 방지하려면 메시지를 표시하기 전에 메시지에서 HTML을 삭제하는 것이 좋습니다.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data	string	머신에서 읽을 수 있는 데이터를 위한 추가 필드입니다. 예를 들어 숫자 또는 JSON 객체가 될 수 있습니다. XSS를 방지하려면 데이터를 표시하기 전에 데이터에서 HTML을 삭제하는 것이 좋습니다.
kind	string
notification[].enterpriseUpgradeEvent	nested object	엔터프라이즈 업그레이드에 관한 알림
notification[].enterpriseUpgradeEvent.upgradeState	string	업그레이드 상태입니다. 허용되는 값은 다음과 같습니다. "upgradeStateSucceeded" "upgradeStateUnspecified"