import
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.
Synopsis
Implements the API documented at https://developers.google.com/gmail/api/reference/rest/v1/users.messages/import
gsm messages import [flags]
Options
--deleted Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator.
Only used for Workspace accounts.
--eml string Path to the local .eml file
--fields string Fields allows partial responses to be retrieved.
See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
-h, --help help for import
--internalDateSource string Source for Gmail's internal date of the message. [DATE_HEADER|RECEIVED_TIME] (default "DATE_HEADER")
--neverMarkSpam Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.
--processForCalendar Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.
--userId string The user's email address. The special value \"me\" can be used to indicate the authenticated user. (default "me")
Options inherited from parent commands
--compressOutput By default, GSM outputs "pretty" (indented) objects. By setting this flag, GSM's output will be compressed. This may or may not improve performance in scripts.
--config string config file (default is $HOME/.config/gsm/.gsm.yaml)
--delay int This delay (plus a random jitter between 0 and 50) will be applied after every command to avoid reaching quota and rate limits. Set to 0 to disable.
--dwdSubject string Specify a subject used for DWD impersonation (overrides value in config file)
--log string Set the path of the log file. Default is either ~/gsm.log or defined in your config file
--maxElapsedTime int This is the maximum total time that will be spent retrying a request in minutes. (default 15)
--maxRetryInterval int This is the maximum interval that will be used between retry attempts in seconds. (default 320)
--redirectPort int This is the TCP port on which GSM will create web server if you authenticate with a user account for the first time. This is necessary for the OAuth flow. See https://developers.google.com/identity/protocols/oauth2/native-app#redirect-uri_loopback (default 8081)
--retryOn ints Specify the HTTP error code(s) that GSM should retry on. Note that GSM will always retry on HTTP 403 errors that indicate a quota / rate limit error
--streamOutput Setting this flag will cause GSM to output slice values to stdout one by one, instead of one large object
SEE ALSO
- gsm messages - Manage users’ messages (Part of Gmail API)
- gsm messages import batch - Batch imports messages using a CSV file as input.