Api-roll 46: 2017-03-06

discovery/googleapis/gmail__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://mail.google.com/": {
-                    "description": "View and manage your mail"
+                    "description": "Read, send, delete, and manage your email"
                 },
                 "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"
                 },
@@ skipping 17 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": "\"tbys6C40o18GZwyMen5GMkdK-3s/bv4LA8S_yqDUVUFrxfui1vcVGzk\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/nNHa5d4TJZ825afZFgDJZn14WPw\"",
     "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 1315 matching lines @@
                                 "$ref": "VacationSettings"
                             },
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.modify",
                                 "https://www.googleapis.com/auth/gmail.readonly",
                                 "https://www.googleapis.com/auth/gmail.settings.basic"
                             ]
                         },
                         "updateAutoForwarding": {
-                            "description": "Updates the auto-forwarding setting for the specified account. A verified forwarding address must be specified when auto-forwarding is enabled.",
+                            "description": "Updates the auto-forwarding setting for the specified account. A verified forwarding address must be specified when auto-forwarding is enabled.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                             "httpMethod": "PUT",
                             "id": "gmail.users.settings.updateAutoForwarding",
                             "parameterOrder": [
                                 "userId"
                             ],
                             "parameters": {
                                 "userId": {
                                     "default": "me",
                                     "description": "User's email address. The special value \"me\" can be used to indicate the authenticated user.",
                                     "location": "path",
@@ skipping 211 matching lines @@
                                         "https://www.googleapis.com/auth/gmail.modify",
                                         "https://www.googleapis.com/auth/gmail.readonly",
                                         "https://www.googleapis.com/auth/gmail.settings.basic"
                                     ]
                                 }
                             }
                         },
                         "forwardingAddresses": {
                             "methods": {
                                 "create": {
-                                    "description": "Creates a forwarding address. If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to pending; otherwise, the resource will be created with verification status set to accepted.",
+                                    "description": "Creates a forwarding address. If ownership verification is required, a message will be sent to the recipient and the resource's verification status will be set to pending; otherwise, the resource will be created with verification status set to accepted.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "POST",
                                     "id": "gmail.users.settings.forwardingAddresses.create",
                                     "parameterOrder": [
                                         "userId"
                                     ],
                                     "parameters": {
                                         "userId": {
                                             "default": "me",
                                             "description": "User's email address. The special value \"me\" can be used to indicate the authenticated user.",
                                             "location": "path",
                                             "required": true,
                                             "type": "string"
                                         }
                                     },
                                     "path": "{userId}/settings/forwardingAddresses",
                                     "request": {
                                         "$ref": "ForwardingAddress"
                                     },
                                     "response": {
                                         "$ref": "ForwardingAddress"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/gmail.settings.sharing"
                                     ]
                                 },
                                 "delete": {
-                                    "description": "Deletes the specified forwarding address and revokes any verification that may have been required.",
+                                    "description": "Deletes the specified forwarding address and revokes any verification that may have been required.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "DELETE",
                                     "id": "gmail.users.settings.forwardingAddresses.delete",
                                     "parameterOrder": [
                                         "userId",
                                         "forwardingEmail"
                                     ],
                                     "parameters": {
                                         "forwardingEmail": {
                                             "description": "The forwarding address to be deleted.",
                                             "location": "path",
@@ skipping 72 matching lines @@
                                         "https://www.googleapis.com/auth/gmail.modify",
                                         "https://www.googleapis.com/auth/gmail.readonly",
                                         "https://www.googleapis.com/auth/gmail.settings.basic"
                                     ]
                                 }
                             }
                         },
                         "sendAs": {
                             "methods": {
                                 "create": {
-                                    "description": "Creates a custom \"from\" send-as alias. If an SMTP MSA is specified, Gmail will attempt to connect to the SMTP service to validate the configuration before creating the alias. If ownership verification is required for the alias, a message will be sent to the email address and the resource's verification status will be set to pending; otherwise, the resource will be created with verification status set to accepted. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.",
+                                    "description": "Creates a custom \"from\" send-as alias. If an SMTP MSA is specified, Gmail will attempt to connect to the SMTP service to validate the configuration before creating the alias. If ownership verification is required for the alias, a message will be sent to the email address and the resource's verification status will be set to pending; otherwise, the resource will be created with verification status set to accepted. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "POST",
                                     "id": "gmail.users.settings.sendAs.create",
                                     "parameterOrder": [
                                         "userId"
                                     ],
                                     "parameters": {
                                         "userId": {
                                             "default": "me",
                                             "description": "User's email address. The special value \"me\" can be used to indicate the authenticated user.",
                                             "location": "path",
                                             "required": true,
                                             "type": "string"
                                         }
                                     },
                                     "path": "{userId}/settings/sendAs",
                                     "request": {
                                         "$ref": "SendAs"
                                     },
                                     "response": {
                                         "$ref": "SendAs"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/gmail.settings.sharing"
                                     ]
                                 },
                                 "delete": {
-                                    "description": "Deletes the specified send-as alias. Revokes any verification that may have been required for using it.",
+                                    "description": "Deletes the specified send-as alias. Revokes any verification that may have been required for using it.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "DELETE",
                                     "id": "gmail.users.settings.sendAs.delete",
                                     "parameterOrder": [
                                         "userId",
                                         "sendAsEmail"
                                     ],
                                     "parameters": {
                                         "sendAsEmail": {
                                             "description": "The send-as alias to be deleted.",
                                             "location": "path",
@@ skipping 68 matching lines @@
                                         "$ref": "ListSendAsResponse"
                                     },
                                     "scopes": [
                                         "https://mail.google.com/",
                                         "https://www.googleapis.com/auth/gmail.modify",
                                         "https://www.googleapis.com/auth/gmail.readonly",
                                         "https://www.googleapis.com/auth/gmail.settings.basic"
                                     ]
                                 },
                                 "patch": {
-                                    "description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias. This method supports patch semantics.",
+                                    "description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.\n\nAddresses other than the primary address for the account can only be updated by service account clients that have been delegated domain-wide authority. This method supports patch semantics.",
                                     "httpMethod": "PATCH",
                                     "id": "gmail.users.settings.sendAs.patch",
                                     "parameterOrder": [
                                         "userId",
                                         "sendAsEmail"
                                     ],
                                     "parameters": {
                                         "sendAsEmail": {
                                             "description": "The send-as alias to be updated.",
                                             "location": "path",
@@ skipping 14 matching lines @@
                                     },
                                     "response": {
                                         "$ref": "SendAs"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/gmail.settings.basic",
                                         "https://www.googleapis.com/auth/gmail.settings.sharing"
                                     ]
                                 },
                                 "update": {
-                                    "description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.",
+                                    "description": "Updates a send-as alias. If a signature is provided, Gmail will sanitize the HTML before saving it with the alias.\n\nAddresses other than the primary address for the account can only be updated by service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "PUT",
                                     "id": "gmail.users.settings.sendAs.update",
                                     "parameterOrder": [
                                         "userId",
                                         "sendAsEmail"
                                     ],
                                     "parameters": {
                                         "sendAsEmail": {
                                             "description": "The send-as alias to be updated.",
                                             "location": "path",
@@ skipping 14 matching lines @@
                                     },
                                     "response": {
                                         "$ref": "SendAs"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/gmail.settings.basic",
                                         "https://www.googleapis.com/auth/gmail.settings.sharing"
                                     ]
                                 },
                                 "verify": {
-                                    "description": "Sends a verification email to the specified send-as alias address. The verification status must be pending.",
+                                    "description": "Sends a verification email to the specified send-as alias address. The verification status must be pending.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.",
                                     "httpMethod": "POST",
                                     "id": "gmail.users.settings.sendAs.verify",
                                     "parameterOrder": [
                                         "userId",
                                         "sendAsEmail"
                                     ],
                                     "parameters": {
                                         "sendAsEmail": {
                                             "description": "The send-as alias to be verified.",
                                             "location": "path",
@@ skipping 446 matching lines @@
                             "scopes": [
                                 "https://mail.google.com/",
                                 "https://www.googleapis.com/auth/gmail.modify"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20170206",
+    "revision": "20170222",
     "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 1070 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "gmail/v1/users/",
     "title": "Gmail API",
     "version": "v1"
 }