Method: users.messages.import

SMTP를 통해 수신하는 것과 유사한 표준 이메일 전송 스캔 및 분류를 사용하여 이 사용자의 메일함으로만 메일을 가져옵니다. 이 방법은 SPF 검사를 실행하지 않으므로 도메인 스푸핑을 시도하는 메일과 같은 일부 스팸 메일에는 작동하지 않을 수 있습니다. 이 메서드는 메시지를 보내지 않습니다. 메일의 최대 크기는 150MB입니다.

HTTP 요청

  • 업로드 URI, 미디어 업로드 요청:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • 메타데이터 URI, 메타데이터 전용 요청:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

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

경로 매개변수

매개변수
userId

string

사용자의 이메일 주소 특수 값 me을 사용하여 인증된 사용자를 나타낼 수 있습니다.

쿼리 매개변수

매개변수
internalDateSource

enum (InternalDateSource)

Gmail의 메시지 내부 날짜 소스입니다.

neverMarkSpam

boolean

Gmail 스팸 분류기 결정을 무시하고 이 이메일을 메일함에서 스팸으로 표시하지 않습니다.

processForCalendar

boolean

이메일의 캘린더 초대를 처리하고 추출된 회의를 이 사용자의 Google Calendar에 추가합니다.

deleted

boolean

이메일을 완전히 삭제된 것으로 표시하고 (휴지통 아님) Vault 관리자에게만 Google Vault에 표시되도록 합니다. Google Workspace 계정에만 사용됩니다.

요청 본문

요청 본문에 Message의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 Message의 인스턴스가 포함됩니다.

승인 범위

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

자세한 내용은 OAuth 2.0 Overview를 참조하세요.