Api-roll 43: 2016-12-13

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"
                 },
@@ skipping 23 matching lines @@
                 }
             }
         }
     },
     "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/V8B0BNh6Gl7mnZWtADepvF4qGmI\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/p_Ki8ZAiDCpzN2N5osErTV2szew\"",
     "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 681 matching lines @@
                                 }
                             },
                             "path": "{userId}/messages/batchDelete",
                             "request": {
                                 "$ref": "BatchDeleteMessagesRequest"
                             },
                             "scopes": [
                                 "https://mail.google.com/"
                             ]
                         },
+                        "batchModify": {
+                            "description": "Modifies the labels on the specified messages.",
+                            "httpMethod": "POST",
+                            "id": "gmail.users.messages.batchModify",
+                            "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}/messages/batchModify",
+                            "request": {
+                                "$ref": "BatchModifyMessagesRequest"
+                            },
+                            "scopes": [
+                                "https://mail.google.com/",
+                                "https://www.googleapis.com/auth/gmail.modify"
+                            ]
+                        },
                         "delete": {
                             "description": "Immediately and permanently deletes the specified message. This operation cannot be undone. Prefer messages.trash instead.",
                             "httpMethod": "DELETE",
                             "id": "gmail.users.messages.delete",
                             "parameterOrder": [
                                 "userId",
                                 "id"
                             ],
                             "parameters": {
                                 "id": {
@@ skipping 243 matching lines @@
                                     "format": "uint32",
                                     "location": "query",
                                     "type": "integer"
                                 },
                                 "pageToken": {
                                     "description": "Page token to retrieve a specific page of results in the list.",
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "q": {
-                                    "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\".",
+                                    "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.",
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "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"
                                 }
@@ skipping 995 matching lines @@
                                     "format": "uint32",
                                     "location": "query",
                                     "type": "integer"
                                 },
                                 "pageToken": {
                                     "description": "Page token to retrieve a specific page of results in the list.",
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "q": {
-                                    "description": "Only return threads matching the specified query. Supports the same query format as the Gmail search box. For example, \"from:someuser@example.com rfc822msgid: is:unread\".",
+                                    "description": "Only return threads 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.",
                                     "location": "query",
                                     "type": "string"
                                 },
                                 "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"
                                 }
@@ skipping 106 matching lines @@
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.modify"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20161019",
+    "revision": "20161206",
     "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 28 matching lines @@
                 "ids": {
                     "description": "The IDs of the messages to delete.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "BatchModifyMessagesRequest": {
+            "id": "BatchModifyMessagesRequest",
+            "properties": {
+                "addLabelIds": {
+                    "description": "A list of label IDs to add to messages.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "ids": {
+                    "description": "The IDs of the messages to modify. There is a limit of 1000 ids per request.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "removeLabelIds": {
+                    "description": "A list of label IDs to remove from messages.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "Draft": {
             "description": "A draft email in the user's mailbox.",
             "id": "Draft",
             "properties": {
                 "id": {
                     "annotations": {
                         "required": [
                             "gmail.users.drafts.send"
                         ]
                     },
@@ skipping 604 matching lines @@
                 "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 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.",
+                    "description": "Number of bytes for the message part data (encoding notwithstanding).",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "MessagePartHeader": {
             "id": "MessagePartHeader",
             "properties": {
                 "name": {
@@ skipping 320 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "gmail/v1/users/",
     "title": "Gmail API",
     "version": "v1"
 }