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. ReferencesIn-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.getdrafts.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

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