Api-roll 46: 2017-03-06

generated/googleapis/lib/gmail/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.gmail.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError, Media, UploadOptions,
     ResumableUploadOptions, DownloadOptions, PartialDownloadOptions,
     ByteRange;
 
 const core.String USER_AGENT = 'dart-api-client gmail/v1';
 
 /** Access Gmail mailboxes including sending user email. */
 class GmailApi {
-  /** View and manage your mail */
+  /** Read, send, delete, and manage your email */
   static const MailGoogleComScope = "https://mail.google.com/";
 
   /** Manage drafts and send emails */
   static const GmailComposeScope = "https://www.googleapis.com/auth/gmail.compose";
 
   /** Insert mail into your mailbox */
   static const GmailInsertScope = "https://www.googleapis.com/auth/gmail.insert";
 
   /** Manage mailbox labels */
   static const GmailLabelsScope = "https://www.googleapis.com/auth/gmail.labels";
@@ skipping 1774 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new VacationSettings.fromJson(data));
   }
 
   /**
    * Updates the auto-forwarding setting for the specified account. A verified
    * forwarding address must be specified when auto-forwarding is enabled.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * Completes with a [AutoForwarding].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 356 matching lines @@
 
   UsersSettingsForwardingAddressesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * 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.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * Completes with a [ForwardingAddress].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 26 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ForwardingAddress.fromJson(data));
   }
 
   /**
    * Deletes the specified forwarding address and revokes any verification that
    * may have been required.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * [forwardingEmail] - The forwarding address to be deleted.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 127 matching lines @@
 
   /**
    * 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.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * Completes with a [SendAs].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 26 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new SendAs.fromJson(data));
   }
 
   /**
    * Deletes the specified send-as alias. Revokes any verification that may have
    * been required for using it.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * [sendAsEmail] - The send-as alias to be deleted.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 112 matching lines @@
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListSendAsResponse.fromJson(data));
   }
 
   /**
    * 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.
+   * the HTML before saving it with the alias.
+   *
+   * Addresses 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.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * [sendAsEmail] - The send-as alias to be updated.
    *
@@ skipping 32 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new SendAs.fromJson(data));
   }
 
   /**
    * Updates a send-as alias. If a signature is provided, Gmail will sanitize
    * the HTML before saving it with the alias.
    *
+   * Addresses other than the primary address for the account can only be
+   * updated by service account clients that have been delegated domain-wide
+   * authority.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * [sendAsEmail] - The send-as alias to be updated.
    *
    * Completes with a [SendAs].
@@ skipping 31 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new SendAs.fromJson(data));
   }
 
   /**
    * Sends a verification email to the specified send-as alias address. The
    * verification status must be pending.
    *
+   * This method is only available to service account clients that have been
+   * delegated domain-wide authority.
+   *
    * Request parameters:
    *
    * [userId] - User's email address. The special value "me" can be used to
    * indicate the authenticated user.
    *
    * [sendAsEmail] - The send-as alias to be verified.
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 2533 matching lines @@
     var _json = new core.Map();
     if (expiration != null) {
       _json["expiration"] = expiration;
     }
     if (historyId != null) {
       _json["historyId"] = historyId;
     }
     return _json;
   }
 }