Method: users.messages.modify

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

HTTP 요청

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

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

경로 매개변수

매개변수
userId

string

사용자의 이메일 주소 특수 값 me를 사용하여 인증된 사용자를 나타낼 수 있습니다.

id

string

수정할 메시지의 ID입니다.

요청 본문

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

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

string

이 메시지에 추가할 라벨 ID 목록입니다. 업데이트마다 라벨을 최대 100개까지 추가할 수 있습니다.

removeLabelIds[]

string

이 메일에서 삭제할 라벨의 목록 ID입니다. 업데이트마다 최대 100개의 라벨을 삭제할 수 있습니다.

응답 본문

성공한 경우 응답 본문에 Message의 인스턴스가 포함됩니다.

승인 범위

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

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

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