REST Resource: users.messages

리소스: Message

이메일 메시지

JSON 표현 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string,
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
필드
id

string

메시지의 변경 불가능한 ID입니다.
threadId

string

메일이 속한 스레드의 ID입니다. 메시지 또는 초안을 스레드에 추가하려면 다음 기준을 충족해야 합니다.

  1. 요청된 threadId는 요청과 함께 제공하는 Message 또는 Draft.Message에 지정되어야 합니다.
  2. References 및 In-Reply-To 헤더는 RFC 2822 표준을 준수하여 설정해야 합니다.
  3. Subject 헤더가 일치해야 합니다.
labelIds[]

string

이 메일에 적용된 라벨의 ID 목록입니다.
snippet

string

메시지 텍스트의 짧은 부분입니다.
historyId

string

이 메시지를 수정한 마지막 기록 레코드의 ID입니다.
internalDate

string (int64 format)

받은편지함의 순서를 결정하는 내부 메시지 생성 타임스탬프 (에포크 ms)입니다. 일반 SMTP 수신 이메일의 경우 이는 Google에서 메일을 처음 수락한 시간을 나타내며 Date 헤더보다 더 신뢰할 수 있습니다. 하지만 API로 이전된 메일의 경우 클라이언트가 Date 헤더를 기반으로 하도록 구성할 수 있습니다.
payload

object (MessagePart)

메일 파트에서 파싱된 이메일 구조입니다.
sizeEstimate

integer

메일의 예상 크기(바이트)입니다.
raw

string (bytes format)

RFC 2822 형식으로 지정되고 base64url로 인코딩된 문자열의 전체 이메일 메시지입니다. format=RAW 매개변수가 제공된 경우 messages.get 및 drafts.get 응답에서 반환됩니다.

base64 인코딩 문자열입니다.
classificationLabelValues[]

object (ClassificationLabelValue)

메일의 분류 라벨 값입니다. 사용 가능한 분류 라벨 스키마는 Google Drive 라벨 API를 사용하여 쿼리할 수 있습니다. 각 분류 라벨 ID는 고유해야 합니다. 중복된 ID가 제공되면 하나만 유지되며 선택은 임의로 이루어집니다. Google Workspace 계정에만 사용됩니다.

MessagePart

단일 MIME 메시지 부분입니다.

JSON 표현 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
필드
partId

string

메일 파트의 변경할 수 없는 ID입니다.
mimeType

string

메시지 부분의 MIME 유형입니다.
filename

string

첨부파일의 파일 이름입니다. 이 메시지 부분이 첨부파일을 나타내는 경우에만 표시됩니다.
headers[]

object (Header)

이 메시지 부분의 헤더 목록입니다. 전체 메시지 페이로드를 나타내는 최상위 메시지 부분의 경우 To, From, Subject와 같은 표준 RFC 2822 이메일 헤더가 포함됩니다.
body

object (MessagePartBody)

이 부분의 메시지 부분 본문입니다. 컨테이너 MIME 메시지 부분의 경우 비어 있을 수 있습니다.
parts[]

object (MessagePart)

이 부분의 하위 MIME 메시지 부분입니다. 이는 컨테이너 MIME 메시지 부분(예: multipart/*)에만 적용됩니다. text/plain과 같은 컨테이너가 아닌 MIME 메시지 파트 유형의 경우 이 필드는 비어 있습니다. 자세한 내용은 RFC 1521을 참고하세요.
JSON 표현 
{
  "name": string,
  "value": string
}
필드
name

string

: 구분자 앞의 헤더 이름입니다. 예를 들면 다음과 같습니다. To
value

string

: 구분 기호 뒤에 오는 헤더 값입니다. 예를 들면 다음과 같습니다. someuser@example.com

ClassificationLabelValue

이메일 메시지에 적용된 분류 라벨입니다. 분류 라벨은 Gmail 받은편지함 라벨과 다릅니다. Google Workspace 계정에만 사용됩니다. 분류 라벨에 대해 자세히 알아보기

JSON 표현 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
필드
labelId

string

필수 항목입니다. 표준 또는 원시 영숫자 분류 라벨 ID입니다. Google Drive 라벨 리소스의 ID 필드에 매핑됩니다.
fields[]

object (ClassificationLabelFieldValue)

지정된 분류 라벨 ID의 필드 값입니다.

ClassificationLabelFieldValue

분류 라벨의 필드 값입니다.

JSON 표현 
{
  "fieldId": string,
  "selection": string
}
필드
fieldId

string

필수 항목입니다. 분류 라벨 값의 필드 ID입니다. Google Drive Label.Field 객체의 ID 필드에 매핑됩니다.
selection

string

선택 옵션의 선택 선택 ID입니다. Google Drive Label.Field 객체의 필드 유형이 SELECTION인 경우에만 설정해야 합니다. Google Drive Label.Field.SelectionOptions 리소스의 ID 필드에 매핑됩니다.

메서드

batchDelete

 메시지 ID로 여러 메시지를 삭제합니다.

batchModify

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

delete

 지정된 메일을 즉시 완전히 삭제합니다.

get

 지정된 메시지를 가져옵니다.

import

 SMTP를 통해 수신하는 것과 유사한 표준 이메일 전송 스캔 및 분류를 사용하여 이 사용자의 메일함에만 메일을 가져옵니다.

insert

 IMAP APPEND와 유사하게 대부분의 스캔 및 분류를 우회하여 이 사용자의 편지함에만 메시지를 직접 삽입합니다.

list

 사용자의 편지함에 있는 메일을 나열합니다.

modify

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

send

 To, Cc, Bcc 헤더의 수신자에게 지정된 메시지를 전송합니다.

trash

 지정된 메일을 휴지통으로 이동합니다.

untrash

 휴지통에서 지정된 메일을 삭제합니다.