gmail.users.messages.import

POST {{baseUrl}}/gmail/v1/users/:userId/messages/import?deleted=<boolean>&internalDateSource=<string>&neverMarkSpam=<boolean>&processForCalendar=<boolean>&$.xgafv=<string>&access_token=<string>&alt=<string>&callback=<string>&fields=<string>&key=<string>&oauth_token=<string>&prettyPrint=<boolean>&quotaUser=<string>&upload_protocol=<string>&uploadType=<string>

Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. Does not send a message. Note: This function doesn't trigger forwarding rules or filters set up by the user.

Request Params

KeyDatatypeRequiredDescription
deletedstringMark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for G Suite accounts.
internalDateSourcestringSource for Gmail's internal date of the message.
neverMarkSpamstringIgnore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
processForCalendarstringProcess calendar invites in the email and add any extracted meetings to the Google Calendar for this user.
$.xgafvstringV1 error format.
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").

Request Body

{"historyId"=>"<string>", "id"=>"<string>", "internalDate"=>"<string>", "labelIds"=>["<string>", "<string>"], "payload"=>{"body"=>{"attachmentId"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "data"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "size"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "filename"=>"laborum cupidatat laboris dolore commodo", "headers"=>[{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, {"value"=>"<Error: Too many levels of nesting to fake this schema>"}], "mimeType"=>"pariatur consectetur culpa", "partId"=>"nisi laboris cillum enim", "parts"=>[{"value"=>"<Circular reference to #/components/schemas/MessagePart detected>"}, {"value"=>"<Circular reference to #/components/schemas/MessagePart detected>"}]}, "raw"=>"<string>", "sizeEstimate"=>"<integer>", "snippet"=>"<string>", "threadId"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{&quot;historyId&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;internalDate&quot;:&quot;\u003cstring\u003e&quot;,&quot;labelIds&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;payload&quot;:{&quot;body&quot;:{&quot;attachmentId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;data&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;size&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;filename&quot;:&quot;aliqua exercitation dolore ullam&quot;,&quot;headers&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}],&quot;mimeType&quot;:&quot;est commodo&quot;,&quot;partId&quot;:&quot;esse velit in&quot;,&quot;parts&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/MessagePart detected\u003e&quot;},{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/MessagePart detected\u003e&quot;}]},&quot;raw&quot;:&quot;\u003cstring\u003e&quot;,&quot;sizeEstimate&quot;:&quot;\u003cinteger\u003e&quot;,&quot;snippet&quot;:&quot;\u003cstring\u003e&quot;,&quot;threadId&quot;:&quot;\u003cstring\u003e&quot;}