Method: alerts.list

알림을 나열합니다.

HTTP 요청

GET https://alertcenter.googleapis.com/v1beta1/alerts

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
customerId

string

선택사항입니다. 알림이 연결된 고객의 Google Workspace 계정의 고유 식별자입니다. customerId에는 초기 'C'가 제거되어야 합니다 (예: 046psxkn). 제공되지 않는 경우 호출자 ID에서 추론됩니다. 고객 ID를 찾습니다.
pageSize

integer

선택사항입니다. 요청된 페이지 크기입니다. 서버가 요청한 것보다 적은 수의 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
pageToken

string

선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 비어 있으면 새 반복이 시작됩니다. 반복을 계속하려면 이전 ListAlertsResponse의 nextPageToken 필드의 값을 전달합니다.
filter

string

선택사항입니다. 알림 결과를 필터링하기 위한 쿼리 문자열입니다. 자세한 내용은 쿼리 필터 및 지원되는 쿼리 필터 필드를 참조하세요.
orderBy

string

선택사항입니다. 목록 결과의 정렬 순서입니다. 지정하지 않으면 임의의 순서로 결과를 반환할 수 있습니다. orderBy="createTime desc"를 사용하여 생성 타임스탬프를 기준으로 결과를 내림차순으로 정렬할 수 있습니다. 현재 지원되는 정렬은 createTime asc, createTime desc, updateTime desc입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

알림 목록 요청에 대한 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
필드
alerts[]

object (Alert)

알림 목록입니다.
nextPageToken

string

다음 페이지의 토큰입니다. 비어 있지 않으면 목록 요청과 일치하는 알림이 더 있을 수 있음을 나타냅니다. 이 값은 후속 ListAlertsRequest에서 현재 목록 호출의 마지막 결과부터 계속 알림을 받는 데 사용할 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/apps.alerts

자세한 내용은 승인 가이드를 참고하세요.