REST Resource: users.messages

리소스: 메시지

이메일 메시지.

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)

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

payload

object (MessagePart)

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

sizeEstimate

integer

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

raw

string (bytes format)

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

base64 인코딩 문자열입니다.

메시지 파트

단일 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)

이 메시지 부분의 헤더 목록입니다. 전체 메시지 페이로드를 나타내는 최상위 메시지 부분에는 표준 RFC 2822 이메일 헤더(예: To, From, Subject)가 포함됩니다.

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

방법

batchDelete

메시지 ID별로 많은 메시지를 삭제합니다.

batchModify

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

delete

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

get

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

import

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

insert

대부분의 스캔 및 분류를 거치지 않고 IMAP APPEND과 유사한 방식으로 사용자의 편지함에만 메시지를 직접 삽입합니다.

list

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

modify

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

send

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

trash

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

untrash

휴지통에서 지정된 메시지를 삭제합니다.