Method: users.messages.batchModify

지정된 메시지의 라벨을 수정합니다.

HTTP 요청

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify

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

경로 매개변수

매개변수
userId

string

사용자의 이메일 주소 특수 값 me는 인증된 사용자를 나타내는 데 사용할 수 있습니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
필드
ids[]

string

수정할 메시지의 ID입니다. 요청당 ID 1,000개로 제한됩니다.

addLabelIds[]

string

메일에 추가할 라벨 ID 목록입니다.

removeLabelIds[]

string

메일에서 삭제할 라벨 ID 목록입니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

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