Api-roll 42: 2016-11-08

discovery/googleapis/gmail__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://mail.google.com/": {
                     "description": "View and manage your mail"
                 },
                 "https://www.googleapis.com/auth/gmail.compose": {
                     "description": "Manage drafts and send emails"
                 },
                 "https://www.googleapis.com/auth/gmail.insert": {
                     "description": "Insert mail into your mailbox"
                 },
                 "https://www.googleapis.com/auth/gmail.labels": {
                     "description": "Manage mailbox labels"
                 },
+                "https://www.googleapis.com/auth/gmail.metadata": {
+                    "description": "View your email message metadata such as labels and headers, but not the email body"
+                },
                 "https://www.googleapis.com/auth/gmail.modify": {
                     "description": "View and modify but not delete your email"
                 },
                 "https://www.googleapis.com/auth/gmail.readonly": {
                     "description": "View your emails messages and settings"
                 },
                 "https://www.googleapis.com/auth/gmail.send": {
                     "description": "Send email on your behalf"
                 },
                 "https://www.googleapis.com/auth/gmail.settings.basic": {
                     "description": "Manage your basic mail settings"
                 },
                 "https://www.googleapis.com/auth/gmail.settings.sharing": {
                     "description": "Manage your sensitive mail settings, including who can manage your mail"
                 }
             }
         }
     },
     "basePath": "/gmail/v1/users/",
     "baseUrl": "https://www.googleapis.com/gmail/v1/users/",
     "batchPath": "batch",
     "description": "Access Gmail mailboxes including sending user email.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/gmail/api/",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/c9szhoCXYrKaLKrzYGmZhJZBHUc\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/V8B0BNh6Gl7mnZWtADepvF4qGmI\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/googlemail-16.png",
         "x32": "https://www.google.com/images/icons/product/googlemail-32.png"
     },
     "id": "gmail:v1",
     "kind": "discovery#restDescription",
     "name": "gmail",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 61 matching lines @@
                             "type": "string"
                         }
                     },
                     "path": "{userId}/profile",
                     "response": {
                         "$ref": "Profile"
                     },
                     "scopes": [
                         "https://mail.google.com/",
                         "https://www.googleapis.com/auth/gmail.compose",
+                        "https://www.googleapis.com/auth/gmail.metadata",
                         "https://www.googleapis.com/auth/gmail.modify",
                         "https://www.googleapis.com/auth/gmail.readonly"
                     ]
                 },
                 "stop": {
                     "description": "Stop receiving push notifications for the given user mailbox.",
                     "httpMethod": "POST",
                     "id": "gmail.users.stop",
                     "parameterOrder": [
                         "userId"
                     ],
                     "parameters": {
                         "userId": {
                             "default": "me",
                             "description": "The user's email address. The special value me can be used to indicate the authenticated user.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{userId}/stop",
                     "scopes": [
                         "https://mail.google.com/",
+                        "https://www.googleapis.com/auth/gmail.metadata",
                         "https://www.googleapis.com/auth/gmail.modify",
                         "https://www.googleapis.com/auth/gmail.readonly"
                     ]
                 },
                 "watch": {
                     "description": "Set up or update a push notification watch on the given user mailbox.",
                     "httpMethod": "POST",
                     "id": "gmail.users.watch",
                     "parameterOrder": [
                         "userId"
                     ],
                     "parameters": {
                         "userId": {
                             "default": "me",
                             "description": "The user's email address. The special value me can be used to indicate the authenticated user.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{userId}/watch",
                     "request": {
                         "$ref": "WatchRequest"
                     },
                     "response": {
                         "$ref": "WatchResponse"
                     },
                     "scopes": [
                         "https://mail.google.com/",
+                        "https://www.googleapis.com/auth/gmail.metadata",
                         "https://www.googleapis.com/auth/gmail.modify",
                         "https://www.googleapis.com/auth/gmail.readonly"
                     ]
                 }
             },
             "resources": {
                 "drafts": {
                     "methods": {
                         "create": {
                             "description": "Creates a new draft with the DRAFT label.",
@@ skipping 314 matching lines @@
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/history",
                             "response": {
                                 "$ref": "ListHistoryResponse"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         }
                     }
                 },
                 "labels": {
                     "methods": {
                         "create": {
                             "description": "Creates a new label.",
@@ skipping 77 matching lines @@
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/labels/{id}",
                             "response": {
                                 "$ref": "Label"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.labels",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "list": {
                             "description": "Lists all labels in the user's mailbox.",
                             "httpMethod": "GET",
                             "id": "gmail.users.labels.list",
                             "parameterOrder": [
                                 "userId"
                             ],
                             "parameters": {
                                 "userId": {
                                     "default": "me",
                                     "description": "The user's email address. The special value me can be used to indicate the authenticated user.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/labels",
                             "response": {
                                 "$ref": "ListLabelsResponse"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.labels",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "patch": {
                             "description": "Updates the specified label. This method supports patch semantics.",
                             "httpMethod": "PATCH",
                             "id": "gmail.users.labels.patch",
                             "parameterOrder": [
                                 "userId",
@@ skipping 165 matching lines @@
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/messages/{id}",
                             "response": {
                                 "$ref": "Message"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "import": {
                             "description": "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.",
                             "httpMethod": "POST",
                             "id": "gmail.users.messages.import",
                             "mediaUpload": {
                                 "accept": [
@@ skipping 179 matching lines @@
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/messages",
                             "response": {
                                 "$ref": "ListMessagesResponse"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "modify": {
                             "description": "Modifies the labels on the specified message.",
                             "httpMethod": "POST",
                             "id": "gmail.users.messages.modify",
                             "parameterOrder": [
                                 "userId",
@@ skipping 939 matching lines @@
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/threads/{id}",
                             "response": {
                                 "$ref": "Thread"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "list": {
                             "description": "Lists the threads in the user's mailbox.",
                             "httpMethod": "GET",
                             "id": "gmail.users.threads.list",
                             "parameterOrder": [
                                 "userId"
@@ skipping 35 matching lines @@
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "{userId}/threads",
                             "response": {
                                 "$ref": "ListThreadsResponse"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.metadata",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly"
                             ]
                         },
                         "modify": {
                             "description": "Modifies the labels applied to the thread. This applies to all messages in the thread.",
                             "httpMethod": "POST",
                             "id": "gmail.users.threads.modify",
                             "parameterOrder": [
                                 "userId",
@@ skipping 88 matching lines @@
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.modify"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20160711",
+    "revision": "20161019",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AutoForwarding": {
             "description": "Auto-forwarding settings for an account.",
             "id": "AutoForwarding",
             "properties": {
                 "disposition": {
                     "description": "The state that a message should be left in after it has been forwarded.",
                     "enum": [
                         "archive",
@@ skipping 647 matching lines @@
         },
         "MessagePartBody": {
             "description": "The body of a single MIME message part.",
             "id": "MessagePartBody",
             "properties": {
                 "attachmentId": {
                     "description": "When present, contains the ID of an external attachment that can be retrieved in a separate messages.attachments.get request. When not present, the entire content of the message part body is contained in the data field.",
                     "type": "string"
                 },
                 "data": {
-                    "description": "The body data of a MIME message part. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.",
+                    "description": "The body data of a MIME message part as a base64url encoded string. May be empty for MIME container types that have no message body or when the body data is sent as a separate attachment. An attachment ID is present if the body data is contained in a separate attachment.",
                     "format": "byte",
                     "type": "string"
                 },
                 "size": {
                     "description": "Total number of bytes in the body of the message part.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
@@ skipping 113 matching lines @@
                 },
                 "threadsTotal": {
                     "description": "The total number of threads in the mailbox.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "SendAs": {
-            "description": "Settings associated with a send-as alias, which can be either the primary login address associated with the account or a custom \"from\" address. Send-as aliases correspond to the \"Send Mail As\" feature in the web interface. See  for more details.",
+            "description": "Settings associated with a send-as alias, which can be either the primary login address associated with the account or a custom \"from\" address. Send-as aliases correspond to the \"Send Mail As\" feature in the web interface.",
             "id": "SendAs",
             "properties": {
                 "displayName": {
                     "description": "A name that appears in the \"From:\" header for mail sent using this alias. For custom \"from\" addresses, when this is empty, Gmail will populate the \"From:\" header with the name that is used for the primary address associated with the account.",
                     "type": "string"
                 },
                 "isDefault": {
                     "description": "Whether this address is selected as the default \"From:\" address in situations such as composing a new message or sending a vacation auto-reply. Every Gmail account has exactly one default send-as address, so the only legal value that clients may write to this field is true. Changing this from false to true for an address will result in this field becoming false for the other previous default address.",
                     "type": "boolean"
                 },
@@ skipping 11 matching lines @@
                 },
                 "signature": {
                     "description": "An optional HTML signature that is included in messages composed with this alias in the Gmail web UI.",
                     "type": "string"
                 },
                 "smtpMsa": {
                     "$ref": "SmtpMsa",
                     "description": "An optional SMTP service that will be used as an outbound relay for mail sent using this alias. If this is empty, outbound mail will be sent directly from Gmail's servers to the destination SMTP service. This setting only applies to custom \"from\" aliases."
                 },
                 "treatAsAlias": {
-                    "description": "Whether Gmail should treat this address as an alias for the user's primary email address. See  for more details. This setting only applies to custom \"from\" aliases.",
+                    "description": "Whether Gmail should  treat this address as an alias for the user's primary email address. This setting only applies to custom \"from\" aliases.",
                     "type": "boolean"
                 },
                 "verificationStatus": {
                     "description": "Indicates whether this address has been verified for use as a send-as alias. Read-only. This setting only applies to custom \"from\" aliases.",
                     "enum": [
                         "accepted",
                         "pending",
                         "verificationStatusUnspecified"
                     ],
                     "enumDescriptions": [
@@ skipping 67 matching lines @@
                     "type": "array"
                 },
                 "snippet": {
                     "description": "A short part of the message text.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "VacationSettings": {
-            "description": "Vacation auto-reply settings for an account. These settings correspond to the \"Vacation responder\" feature in the web interface. See  for more details.",
+            "description": "Vacation auto-reply settings for an account. These settings correspond to the \"Vacation responder\" feature in the web interface.",
             "id": "VacationSettings",
             "properties": {
                 "enableAutoReply": {
                     "description": "Flag that controls whether Gmail automatically replies to messages.",
                     "type": "boolean"
                 },
                 "endTime": {
                     "description": "An optional end time for sending auto-replies (epoch ms). When this is specified, Gmail will automatically reply only to messages that it receives before the end time. If both startTime and endTime are specified, startTime must precede endTime.",
                     "format": "int64",
                     "type": "string"
@@ skipping 71 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "gmail/v1/users/",
     "title": "Gmail API",
     "version": "v1"
 }