15.0.0 (#681)

CHANGELOG.md

@@ -1,3 +1,22 @@
+##### 15.0.0 - 05 December 2016
+
+###### Breaking changes
+- Deleted `dfareporting` `v2.4` API
+- Deleted `genomics` `v1beta2` API
+- Deleted some methods from the `youtubeanalytics` `v1` API
+- Deleted some methods from the `youtubeanalytics` `v1beta1` API
+
+###### Backwards compatible changes
+- Added new methods to the `cloudbuild` `v1` API
+- Added new methods to the `compute` `alpha` API
+- Added new methods to the `compute` `beta` API
+- Added new methods to the `gmail` `v1` API
+- Added the `language` `v1` API
+- Added new methods to the `language` `v1beta1` API
+- Added new methods to the `logging` `v2` API
+- Added new methods to the `logging` `v2beta1` API
+- Added new methods to the `runtimeconfig` `v1beta1` API
+
 ##### 14.2.0 - 08 November 2016
 
 ###### Backwards compatible changes

apis/analyticsreporting/v4.js

@@ -304,6 +304,8 @@ for details.
 empty when `hideValueRanges` in the request is false, or when
 rowCount is zero.
 * @property {analyticsreporting(v4).ReportRow[]} rows There's one ReportRow for every unique combination of dimensions.
+* @property {string} dataLastRefreshed The last time the data in the report was refreshed. All the hits received
+before this timestamp are included in the calculation of the report.
 * @property {analyticsreporting(v4).DateRangeValues[]} totals For each requested date range, for the set of all rows that match
 the query, every requested value format gets a total. The total
 for a value format is computed by first totaling the metrics

apis/androidenterprise/v1.js

@@ -3745,7 +3745,7 @@ Possible values include:
  * @type object
  * @property {string} kind Identifies what kind of resource this is. Value: the fixed string "androidenterprise#productSet".
  * @property {string[]} productId The list of product IDs making up the set of products.
- * @property {string} productSetBehavior The interpretation of this product set. "unknown" should never be sent and ignored if received. "whitelist" means that this product set constitutes a whitelist. "includeAll" means that all products are accessible (the value of the productId field is therefore ignored). If a value is not supplied, it is interpreted to be "whitelist" for backwards compatibility.
+ * @property {string} productSetBehavior The interpretation of this product set. "unknown" should never be sent and ignored if received. "whitelist" means that this product set constitutes a whitelist. "includeAll" means that all products are accessible, including products that are approved, not approved, and even products where approval has been revoked. If the value is "includeAll", the value of the productId field is therefore ignored. If a value is not supplied, it is interpreted to be "whitelist" for backwards compatibility.
  */
 /**
  * @typedef ProductsApproveRequest

apis/appengine/v1.js

@@ -198,13 +198,13 @@ function Appengine(options) { // eslint-disable-line
     /**
      * appengine.apps.patch
      *
-     * @desc Updates application fields.
+     * @desc Updates the specified Application resource. You can update the following fields: * [`auth_domain`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps#Application.FIELDS.auth_domain) * [`default_cookie_expiration`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps#Application.FIELDS.default_cookie_expiration)
      *
      * @alias appengine.apps.patch
      * @memberOf! appengine(v1)
      *
      * @param {object} params Parameters for request
-     * @param {string} params.appsId Part of `name`. Name of the application to update. Example: `apps/myapp`.
+     * @param {string} params.appsId Part of `name`. Name of the Application resource to update. Example: `apps/myapp`.
      * @param {string=} params.updateMask Standard field mask for the set of fields to be updated.
      * @param {appengine(v1).Application} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -235,7 +235,7 @@ function Appengine(options) { // eslint-disable-line
     /**
      * appengine.apps.repair
      *
-     * @desc Recreates the required App Engine features for the application in your project, for example a Cloud Storage bucket or App Engine service account. Use this method if you receive an error message about a missing feature, for example "*Error retrieving the App Engine service account*".
+     * @desc Recreates the required App Engine features for the specified App Engine application, for example a Cloud Storage bucket or App Engine service account. Use this method if you receive an error message about a missing feature, for example, *Error retrieving the App Engine service account*.
      *
      * @alias appengine.apps.repair
      * @memberOf! appengine(v1)
@@ -1116,6 +1116,15 @@ function Appengine(options) { // eslint-disable-line
  * @property {number} cpu Number of CPU cores needed.
  * @property {number} diskGb Disk size (GB) needed.
  * @property {number} memoryGb Memory (GB) needed.
+ * @property {appengine(v1).Volume[]} volumes User specified volumes.
+ */
+/**
+ * @typedef Volume
+ * @memberOf! appengine(v1)
+ * @type object
+ * @property {string} name Unique name for the volume.
+ * @property {string} volumeType Underlying volume type, e.g. 'tmpfs'.
+ * @property {number} sizeGb Volume size in GB.
  */
 /**
  * @typedef UrlMap

apis/appengine/v1beta4.js

@@ -116,13 +116,13 @@ function Appengine(options) { // eslint-disable-line
     /**
      * appengine.apps.patch
      *
-     * @desc Updates application fields.
+     * @desc Updates the specified Application resource. You can update the following fields: * [`auth_domain`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps#Application.FIELDS.auth_domain) * [`default_cookie_expiration`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta4/apps#Application.FIELDS.default_cookie_expiration)
      *
      * @alias appengine.apps.patch
      * @memberOf! appengine(v1beta4)
      *
      * @param {object} params Parameters for request
-     * @param {string} params.appsId Part of `name`. Name of the application to update. For example: "apps/myapp".
+     * @param {string} params.appsId Part of `name`. Name of the Application resource to update. Example: `apps/myapp`.
      * @param {string=} params.mask Standard field mask for the set of fields to be updated.
      * @param {appengine(v1beta4).Application} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -962,6 +962,15 @@ function Appengine(options) { // eslint-disable-line
  * @property {number} cpu Number of CPU cores needed.
  * @property {number} diskGb Disk size (GB) needed.
  * @property {number} memoryGb Memory (GB) needed.
+ * @property {appengine(v1beta4).Volume[]} volumes User specified volumes.
+ */
+/**
+ * @typedef Volume
+ * @memberOf! appengine(v1beta4)
+ * @type object
+ * @property {string} name Unique name for the volume.
+ * @property {string} volumeType Underlying volume type, e.g. 'tmpfs'.
+ * @property {number} sizeGb Volume size in GB.
  */
 /**
  * @typedef UrlMap

apis/appengine/v1beta5.js

@@ -116,13 +116,13 @@ function Appengine(options) { // eslint-disable-line
     /**
      * appengine.apps.patch
      *
-     * @desc Updates application fields.
+     * @desc Updates the specified Application resource. You can update the following fields: * [`auth_domain`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.auth_domain) * [`default_cookie_expiration`](https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.default_cookie_expiration)
      *
      * @alias appengine.apps.patch
      * @memberOf! appengine(v1beta5)
      *
      * @param {object} params Parameters for request
-     * @param {string} params.appsId Part of `name`. Name of the application to update. Example: `apps/myapp`.
+     * @param {string} params.appsId Part of `name`. Name of the Application resource to update. Example: `apps/myapp`.
      * @param {string=} params.mask Standard field mask for the set of fields to be updated.
      * @param {appengine(v1beta5).Application} params.resource Request body data
      * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -963,6 +963,15 @@ function Appengine(options) { // eslint-disable-line
  * @property {number} cpu Number of CPU cores needed.
  * @property {number} diskGb Disk size (GB) needed.
  * @property {number} memoryGb Memory (GB) needed.
+ * @property {appengine(v1beta5).Volume[]} volumes Volumes mounted within the app container.
+ */
+/**
+ * @typedef Volume
+ * @memberOf! appengine(v1beta5)
+ * @type object
+ * @property {string} name Unique name for the volume.
+ * @property {string} volumeType Underlying volume type, e.g. 'tmpfs'.
+ * @property {number} sizeGb Volume size in GB.
  */
 /**
  * @typedef UrlMap

apis/books/v1.js

@@ -2202,6 +2202,7 @@ function Books(options) { // eslint-disable-line
  * @property {boolean} dont_show_notification 
  * @property {string} iconUrl 
  * @property {string} kind Resource type.
+ * @property {string} notificationGroup 
  * @property {string} notification_type 
  * @property {string} pcampaign_id 
  * @property {string} reason 

apis/cloudbuild/v1.js

@@ -448,6 +448,42 @@ function Cloudbuild(options) { // eslint-disable-line
         context: self
       };
 
+      return createAPIRequest(parameters, callback);
+    },
+
+    /**
+     * cloudbuild.operations.cancel
+     *
+     * @desc Starts asynchronous cancellation on a long-running operation.  The server makes a best effort to cancel the operation, but success is not guaranteed.  If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.  Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
+     *
+     * @alias cloudbuild.operations.cancel
+     * @memberOf! cloudbuild(v1)
+     *
+     * @param {object} params Parameters for request
+     * @param {string} params.name The name of the operation resource to be cancelled.
+     * @param {cloudbuild(v1).CancelOperationRequest} params.resource Request body data
+     * @param {object} [options] Optionally override request options, such as `url`, `method`, and `encoding`.
+     * @param {callback} callback The callback that handles the response.
+     * @return {object} Request object
+     */
+    cancel: function (params, options, callback) {
+      if (typeof options === 'function') {
+        callback = options;
+        options = {};
+      }
+      options || (options = {});
+
+      var parameters = {
+        options: utils.extend({
+          url: 'https://cloudbuild.googleapis.com/v1/{name}:cancel',
+          method: 'POST'
+        }, options),
+        params: params,
+        requiredParams: ['name'],
+        pathParams: ['name'],
+        context: self
+      };
+
       return createAPIRequest(parameters, callback);
     }
 
@@ -558,6 +594,11 @@ presented to `docker push`.
  * @property {string} value The hash value.
  * @property {string} type The type of hash that was performed.
  */
+/**
+ * @typedef CancelOperationRequest
+ * @memberOf! cloudbuild(v1)
+ * @type object
+ */
 /**
  * @typedef StorageSource
  * @memberOf! cloudbuild(v1)
@@ -593,6 +634,9 @@ build.
 @OutputOnly
 * @property {cloudbuild(v1).BuildOptions} options Special options for this build.
 * @property {string} finishTime Time at which execution of the build was finished.
+
+The difference between finish_time and start_time is the duration of the
+build's execution.
 @OutputOnly
 * @property {string} timeout Amount of time that this build should be allowed to run, to second
 granularity. If this amount of time elapses, work on the build will cease
@@ -601,7 +645,7 @@ and the build status will be TIMEOUT.
 Default time is ten minutes.
 * @property {cloudbuild(v1).BuildStep[]} steps Describes the operations to be performed on the workspace.
 * @property {cloudbuild(v1).Source} source Describes where to find the source files to build.
-* @property {string} createTime Time at which the build was created.
+* @property {string} createTime Time at which the request to create the build was received.
 @OutputOnly
 * @property {string} logUrl URL to logs for this build in Google Cloud Logging.
 @OutputOnly
@@ -618,7 +662,6 @@ results field.
 
 If any of the images fail to be pushed, the build is marked FAILURE.
 * @property {string} startTime Time at which execution of the build was started.
-@OutputOnly
 * @property {string} buildTriggerId The ID of the BuildTrigger that triggered this build, if it was
 triggered automatically.
 @OutputOnly
@@ -641,17 +684,17 @@ Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
  * @type object
  */
 /**
- * @typedef FileHashes
+ * @typedef ListOperationsResponse
  * @memberOf! cloudbuild(v1)
  * @type object
- * @property {cloudbuild(v1).Hash[]} fileHash Collection of file hashes.
+ * @property {string} nextPageToken The standard List next-page token.
+ * @property {cloudbuild(v1).Operation[]} operations A list of operations that matches the specified filter in the request.
  */
 /**
- * @typedef ListOperationsResponse
+ * @typedef FileHashes
  * @memberOf! cloudbuild(v1)
  * @type object
- * @property {string} nextPageToken The standard List next-page token.
- * @property {cloudbuild(v1).Operation[]} operations A list of operations that matches the specified filter in the request.
+ * @property {cloudbuild(v1).Hash[]} fileHash Collection of file hashes.
  */
 /**
  * @typedef RepoSource

apis/clouderrorreporting/v1beta1.js

@@ -90,6 +90,7 @@ function Clouderrorreporting(options) { // eslint-disable-line
        *
        * @param {object} params Parameters for request
        * @param {string=} params.timeRange.period Restricts the query to the specified time range.
+       * @param {string=} params.serviceFilter.resourceType [Optional] The exact value to match against [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
        * @param {string} params.projectName [Required] The resource name of the Google Cloud Platform project. Written as `projects/` plus the [Google Cloud Platform project ID](https://support.google.com/cloud/answer/6158840). Example: `projects/my-project-123`.
        * @param {string=} params.serviceFilter.service [Optional] The exact value to match against [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service).
        * @param {string=} params.groupId [Required] The group for which events shall be returned.
@@ -245,6 +246,7 @@ function Clouderrorreporting(options) { // eslint-disable-line
        * @param {object} params Parameters for request
        * @param {string=} params.alignment [Optional] The alignment of the timed counts to be returned. Default is `ALIGNMENT_EQUAL_AT_END`.
        * @param {string=} params.timeRange.period Restricts the query to the specified time range.
+       * @param {string=} params.serviceFilter.resourceType [Optional] The exact value to match against [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
        * @param {string} params.projectName [Required] The resource name of the Google Cloud Platform project. Written as <code>projects/</code> plus the <a href="https://support.google.com/cloud/answer/6158840">Google Cloud Platform project ID</a>.  Example: <code>projects/my-project-123</code>.
        * @param {string=} params.order [Optional] The sort order in which the results are returned. Default is `COUNT_DESC`.
        * @param {string=} params.groupId [Optional] List all <code>ErrorGroupStats</code> with these IDs.
@@ -374,6 +376,11 @@ distinguish affected users. See `affected_users_count` in
  * @typedef ServiceContext
  * @memberOf! clouderrorreporting(v1beta1)
  * @type object
+* @property {string} resourceType Type of the MonitoredResource. List of possible values:
+https://cloud.google.com/monitoring/api/resources
+
+Value is set automatically for incoming errors and must not be set when
+reporting errors.
 * @property {string} service An identifier of the service, such as the name of the
 executable, job, or Google App Engine service name. This field is expected
 to have a low number of values that are relatively stable over time, as