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
}
필드
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)

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

object (MessagePart)

메시지 부분에서 파싱된 이메일 구조입니다.
sizeEstimate

integer

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

string (bytes format)

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

base64 인코딩 문자열입니다.

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/*)에만 적용됩니다. 비컨테이너 MIME 메시지 부분 유형(예: text/plain)의 경우 이 필드는 비어 있습니다. 자세한 내용은 RFC 1521을 참조하세요.
JSON 표현 
{
  "name": string,
  "value": string
}
필드
name

string

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

string

: 구분자 뒤의 헤더 값입니다. 예를 들면 someuser@example.com입니다.

메서드

batchDelete

 메시지 ID를 기준으로 여러 개의 메일을 삭제합니다.

batchModify

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

delete

 지정된 메시지를 즉시 영구적으로 삭제합니다.

get

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

import

 SMTP를 통해 수신하는 것과 비슷한 표준 이메일 전송 검사 및 분류를 사용하여 메일을 이 사용자의 편지함으로만 가져옵니다.

insert

 IMAP APPEND과(와) 유사한 이 사용자의 편지함에만 메일을 직접 삽입하며 대부분의 검사 및 분류를 건너뜁니다.

list

 사용자 편지함에 있는 메시지를 나열합니다.

modify

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

send

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

trash

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

untrash

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