openapi-directory/api/googleapis.com/gmail.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"url":"https://gmail.googleapis.com/"}],"x-hasEquivalentPaths":true,"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"The Gmail API lets you view and manage Gmail mailbox data like threads, messages, and labels.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Gmail API","version":"v1","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"x-origin":[{"format":"google","url":"https://gmail.googleapis.com/$discovery/rest?version=v1","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"gmail"},"externalDocs":{"url":"https://developers.google.com/gmail/api/"},"tags":[{"name":"users"}],"paths":{"/gmail/v1/users/{userId}/drafts":{"get":{"description":"Lists the drafts in the user's mailbox.","operationId":"gmail.users.drafts.list","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Include drafts from `SPAM` and `TRASH` in the results.","in":"query","name":"includeSpamTrash","schema":{"type":"boolean"}},{"description":"Maximum number of drafts to return. This field defaults to 100. The maximum allowed value for this field is 500.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Page token to retrieve a specific page of results in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Only return draft messages matching the specified query. Supports the same query format as the Gmail search box. For example, `\"from:someuser@example.com rfc822msgid: is:unread\"`.","in":"query","name":"q","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDraftsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a new draft with the `DRAFT` label.","operationId":"gmail.users.drafts.create","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/news":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/drafts/send":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Sends the specified, existing draft to the recipients in the `To`, `Cc`, and `Bcc` headers.","operationId":"gmail.users.drafts.send","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/news":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/drafts/{id}":{"delete":{"description":"Immediately and permanently deletes the specified draft. Does not simply trash it.","operationId":"gmail.users.drafts.delete","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the draft to delete.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]},"get":{"description":"Gets the specified draft.","operationId":"gmail.users.drafts.get","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the draft to retrieve.","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"The format to return the draft in.","in":"query","name":"format","schema":{"enum":["minimal","full","raw","metadata"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"put":{"description":"Replaces a draft's content.","operationId":"gmail.users.drafts.update","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the draft to update.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/news":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Draft"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/history":{"get":{"description":"Lists the history of all changes to the given mailbox. History results are returned in chronological order (increasing `historyId`).","operationId":"gmail.users.history.list","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"History types to be returned by the function","explode":true,"in":"query","name":"historyTypes","schema":{"items":{"enum":["messageAdded","messageDeleted","labelAdded","labelRemoved"],"type":"string"},"type":"array"},"style":"form"},{"description":"Only return messages with a label matching the ID.","in":"query","name":"labelId","schema":{"type":"string"}},{"description":"Maximum number of history records to return. This field defaults to 100. The maximum allowed value for this field is 500.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Page token to retrieve a specific page of results in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Required. Returns history records after the specified `startHistoryId`. The supplied `startHistoryId` should be obtained from the `historyId` of a message, thread, or previous `list` response. History IDs increase chronologically but are not contiguous with random gaps in between valid IDs. Supplying an invalid or out of date `startHistoryId` typically returns an `HTTP 404` error code. A `historyId` is typically valid for at least a week, but in some rare circumstances may be valid for only a few hours. If you receive an `HTTP 404` error response, your application should perform a full sync. If you receive no `nextPageToken` in the response, there are no updates to retrieve and you can store the returned `historyId` for a future request.","in":"query","name":"startHistoryId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListHistoryResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/gmail/v1/users/{userId}/labels":{"get":{"description":"Lists all labels in the user's mailbox.","operationId":"gmail.users.labels.list","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListLabelsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a new label.","operationId":"gmail.users.labels.create","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/labels/{id}":{"delete":{"description":"Immediately and permanently deletes the specified label and removes it from any messages and threads that it is applied to.","operationId":"gmail.users.labels.delete","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the label to delete.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]},"get":{"description":"Gets the specified label.","operationId":"gmail.users.labels.get","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the label to retrieve.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"patch":{"description":"Patch the specified label.","operationId":"gmail.users.labels.patch","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the label to update.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]},"put":{"description":"Updates the specified label.","operationId":"gmail.users.labels.update","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the label to update.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.labels"],"Oauth2c":["https://www.googleapis.com/auth/gmail.labels"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages":{"get":{"description":"Lists the messages in the user's mailbox.","operationId":"gmail.users.messages.list","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Include messages from `SPAM` and `TRASH` in the results.","in":"query","name":"includeSpamTrash","schema":{"type":"boolean"}},{"description":"Only return messages with labels that match all of the specified label IDs. Messages in a thread might have labels that other messages in the same thread don't have. To learn more, see [Manage labels on messages and threads](https://developers.google.com/gmail/api/guides/labels#manage_labels_on_messages_threads).","explode":true,"in":"query","name":"labelIds","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Maximum number of messages to return. This field defaults to 100. The maximum allowed value for this field is 500.","in":"query","name":"maxResults","schema":{"type":"integer"}},{"description":"Page token to retrieve a specific page of results in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Only return messages matching the specified query. Supports the same query format as the Gmail search box. For example, `\"from:someuser@example.com rfc822msgid: is:unread\"`. Parameter cannot be used when accessing the api using the gmail.metadata scope.","in":"query","name":"q","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMessagesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Directly inserts a message into only this user's mailbox similar to `IMAP APPEND`, bypassing most scanning and classification. Does not send a message.","operationId":"gmail.users.messages.insert","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for Google Workspace accounts.","in":"query","name":"deleted","schema":{"type":"boolean"}},{"description":"Source for Gmail's internal date of the message.","in":"query","name":"internalDateSource","schema":{"enum":["receivedTime","dateHeader"],"type":"string"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Message"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Message"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Message"}},"message/http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Message"}},"message/news":{"schema":{"$ref":"#/components/schemas/Message"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Message"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Message"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Message"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Message"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.insert"],"Oauth2c":["https://www.googleapis.com/auth/gmail.insert"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/batchDelete":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Deletes many messages by message ID. Provides no guarantees that messages were not already deleted or even existed at all.","operationId":"gmail.users.messages.batchDelete","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDeleteMessagesRequest"}}}},"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/batchModify":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Modifies the labels on the specified messages.","operationId":"gmail.users.messages.batchModify","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchModifyMessagesRequest"}}}},"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/import":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Imports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message.","operationId":"gmail.users.messages.import","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"Mark the email as permanently deleted (not TRASH) and only visible in Google Vault to a Vault administrator. Only used for Google Workspace accounts.","in":"query","name":"deleted","schema":{"type":"boolean"}},{"description":"Source for Gmail's internal date of the message.","in":"query","name":"internalDateSource","schema":{"enum":["receivedTime","dateHeader"],"type":"string"}},{"description":"Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox.","in":"query","name":"neverMarkSpam","schema":{"type":"boolean"}},{"description":"Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user.","in":"query","name":"processForCalendar","schema":{"type":"boolean"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Message"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Message"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Message"}},"message/http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Message"}},"message/news":{"schema":{"$ref":"#/components/schemas/Message"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Message"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Message"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Message"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Message"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.insert"],"Oauth2c":["https://www.googleapis.com/auth/gmail.insert"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/send":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Sends the specified message to the recipients in the `To`, `Cc`, and `Bcc` headers. For example usage, see [Sending email](https://developers.google.com/gmail/api/guides/sending).","operationId":"gmail.users.messages.send","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"message/cpim":{"schema":{"$ref":"#/components/schemas/Message"}},"message/delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/external-body":{"schema":{"$ref":"#/components/schemas/Message"}},"message/feedback-report":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-delivery-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-disposition-notification":{"schema":{"$ref":"#/components/schemas/Message"}},"message/global-headers":{"schema":{"$ref":"#/components/schemas/Message"}},"message/http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/imdn+xml":{"schema":{"$ref":"#/components/schemas/Message"}},"message/news":{"schema":{"$ref":"#/components/schemas/Message"}},"message/partial":{"schema":{"$ref":"#/components/schemas/Message"}},"message/rfc822":{"schema":{"$ref":"#/components/schemas/Message"}},"message/s-http":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sip":{"schema":{"$ref":"#/components/schemas/Message"}},"message/sipfrag":{"schema":{"$ref":"#/components/schemas/Message"}},"message/tracking-status":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.si.simp":{"schema":{"$ref":"#/components/schemas/Message"}},"message/vnd.wfa.wsc":{"schema":{"$ref":"#/components/schemas/Message"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.action.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.send"],"Oauth2c":["https://www.googleapis.com/auth/gmail.send"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/{id}":{"delete":{"description":"Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer `messages.trash` instead.","operationId":"gmail.users.messages.delete","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message to delete.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]}],"tags":["users"]},"get":{"description":"Gets the specified message.","operationId":"gmail.users.messages.get","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message to retrieve. This ID is usually retrieved using `messages.list`. The ID is also contained in the result when a message is inserted (`messages.insert`) or imported (`messages.import`).","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"The format to return the message in.","in":"query","name":"format","schema":{"enum":["minimal","full","raw","metadata"],"type":"string"}},{"description":"When given and format is `METADATA`, only include headers specified.","explode":true,"in":"query","name":"metadataHeaders","schema":{"items":{"type":"string"},"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.message.action"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.message.action"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.message.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.message.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.message.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.message.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/gmail/v1/users/{userId}/messages/{id}/modify":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Modifies the labels on the specified message.","operationId":"gmail.users.messages.modify","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message to modify.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModifyMessageRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/{id}/trash":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Moves the specified message to the trash.","operationId":"gmail.users.messages.trash","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message to Trash.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/{id}/untrash":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Removes the specified message from the trash.","operationId":"gmail.users.messages.untrash","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message to remove from Trash.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]}],"tags":["users"]}},"/gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}":{"get":{"description":"Gets the specified message attachment.","operationId":"gmail.users.messages.attachments.get","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"The ID of the message containing the attachment.","in":"path","name":"messageId","required":true,"schema":{"type":"string"}},{"description":"The ID of the attachment.","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePartBody"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.message.action"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.message.action"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.addons.current.message.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.addons.current.message.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/gmail/v1/users/{userId}/profile":{"get":{"description":"Gets the current user's Gmail profile.","operationId":"gmail.users.getProfile","parameters":[{"description":"The user's email address. The special value `me` can be used to indicate the authenticated user.","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://mail.google.com/"],"Oauth2c":["https://mail.google.com/"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.compose"],"Oauth2c":["https://www.googleapis.com/auth/gmail.compose"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.metadata"],"Oauth2c":["https://www.googleapis.com/auth/gmail.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.modify"],"Oauth2c":["https://www.googleapis.com/auth/gmail.modify"]},{"Oauth2":["https://www.googleapis.com/auth/gmail.readonly"],"Oauth2c":["https://www.googleapis.com/auth/gmail.readonly"]}],"tags":["users"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$r