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

자세한 내용은 승인 가이드를 참고하세요.