Method: users.labels.list

사용자 편지함에 있는 모든 라벨을 나열합니다.

HTTP 요청

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/labels

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

경로 매개변수

매개변수
userId

string

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

요청 본문

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

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "labels": [
    {
      object (Label)
    }
  ]
}
필드
labels[]

object (Label)

라벨 목록입니다. 각 라벨 리소스에는 id, name, messageListVisibility, labelListVisibility, type만 포함됩니다. labels.get 메서드는 추가 라벨 세부정보를 가져올 수 있습니다.

승인 범위

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

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

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